Skip to main content

overwriteAccountingItemFromExternal

Replaces every field on the endless-owned accounting item with the values currently held for the connected provider's copy of it. If the product has no internal accounting item, creates one from that external copy and links the two records.

This reads the provider projection Endless already holds; it does not call the provider. Use pushProductToAccounting to send values the other way, and an import to refresh the projection first.

Business Rules​

  • The provider copy must already be imported and have a single exact SKU match for the product when the product is not already linked to it.
  • Applies regardless of the integration's accounting_source_of_truth setting. That setting governs whether imports may overwrite Endless records, not whether an operator may ask for this explicitly.
  • Unsaved operator edits to the accounting item are lost.

Error Scenarios​

  • **BAD_REQUEST**: the integration does not belong to this company, or an unlinked product does not have exactly one imported provider item matching its SKU.
  • **NOT_FOUND**: the integration does not exist.

Permissions Required​

  • accounting:configure_product_accounting permission.
overwriteAccountingItemFromExternal(
  input: OverwriteAccountingItemFromExternalInput!
): OverwriteAccountingItemFromExternalPayload

Arguments​

overwriteAccountingItemFromExternal.input ● OverwriteAccountingItemFromExternalInput! non-null input common​

Parameters for OverwriteAccountingItemFromExternal

Type​

OverwriteAccountingItemFromExternalPayload object common​

Autogenerated return type of OverwriteAccountingItemFromExternal.