POST
Write the transfer-pricing answers of a year (organization)
Organization space Accounting module For: Accountant · Permission: transfer_pricing_narratives.create Conditions
  • The accounting module must be part of the organization’s plan.
  • In the organization space, the caller must have access to the book.
  • fiscal_year_id is required and must be a fiscal year of the book. A fiscal year has one set of answers: a second set is refused, update the existing one.
  • payload is required and an object that holds only the questions ultimate_parent_name, ultimate_parent_address, ultimate_parent_country, group_activities, group_pricing_policy, intangibles, restructuring_occurred, restructuring_description, advance_pricing_agreement, advance_pricing_description, significant_change and observations; any other key is refused. Each question may be null or left out.
  • restructuring_occurred, advance_pricing_agreement and significant_change are true or false; ultimate_parent_country is two letters (ISO 3166-1 alpha-2); the others are text of 10,000 characters at most.
What else happens
  • Creates the answers exactly as sent and records who wrote them (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

book
string
required

Identifier of the accounting book (27-character KSUID string) whose records are worked on.

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: .

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.