PUT
Replace the transfer-pricing answers of a year (organization)
Organization space Accounting module For: Accountant · Permission: transfer_pricing_narratives.update Conditions
  • The accounting module must be part of the organization’s plan.
  • In the organization space, the caller must have access to the book.
  • payload is required and replaces all the previous answers: a question left out is no longer answered. The same questions and rules as when the answers are written apply.
  • The fiscal year never changes.
What else happens
  • Records who made the change (updated_by and updated_by_type).
  • A transfer-pricing draft of that year becomes stale and must be regenerated before it is filed.
Part of Declare transfer pricing.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

transferPricingNarrative
string
required

Identifier of the accounting book (the {book} segment of the organization space, a 27-character KSUID string); the OpenAPI generator names it after the controller argument.

transfer_pricing_narrative
string
required

Identifier of the written answers of a fiscal year (27-character KSUID string), those of the book.

Query Parameters

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none,
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, owner_type, fiscal_year_id, payload, updated_by, updated_by_type, created_at, updated_at.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .

Body

application/json

Replaces the written answers of the year. The fiscal year does not change.

payload
object
required

The written answers: an object that holds only the questions below; any other key is refused. Required. It replaces all the previous answers.

Response

Resource (only with response=resource).

id

Identifier of the answers (27-character KSUID string).

owner_type

Kind of book that holds the answers: organization, company or client account.

fiscal_year_id

Identifier of the fiscal year the answers are for (27-character KSUID string).

payload
object

The written answers, as saved: an object with the questions that were sent. A question never sent is absent. The questions are:

  • advance_pricing_agreement: Whether an advance pricing agreement exists.
  • advance_pricing_description: Description of the advance pricing agreement.
  • group_activities: Description of the activities of the group.
  • group_pricing_policy: Description of the transfer-pricing policy of the group.
  • intangibles: Description of the intangible assets of the group.
  • observations: Free observations.
  • restructuring_description: Description of the restructuring.
  • restructuring_occurred: Whether a restructuring occurred during the year.
  • significant_change: Whether a significant change occurred during the year.
  • ultimate_parent_address: Address of the ultimate parent entity.
  • ultimate_parent_country: Country of the ultimate parent entity (ISO 3166-1 alpha-2).
  • ultimate_parent_name: Name of the ultimate parent entity of the group.
updated_by

Identifier of the member or agent account who wrote or last changed them; null when the actor could not be resolved.

updated_by_type

Kind of actor in updated_by (member or agent account); null when none could be resolved.

created_at

When the answers were first written, ISO 8601.

updated_at

When the answers were last changed, ISO 8601.