Skip to main content

pullAccountingVendor

Refreshes one supplier’s copy of its vendor in the connected accounting provider.

Enqueues a background job, so completion is asynchronous. Once it lands, the supplier’s accountingVendor.external reflects the provider’s current values. The response returns processId; follow processStatusUpdates(processId:) or query processStatus(processId:) for completion and failure reasons.

Business Rules​

  • The provider’s vendor is located by the supplier’s active link, or by matching the vendor’s display name when no link exists.
  • The endless-owned accounting vendor is never overwritten by this action, whatever the integration’s accounting_source_of_truth setting says. Use overwriteAccountingVendorFromExternal to adopt the provider’s values deliberately.

Error Scenarios​

  • **VALIDATION**: the integration cannot supply accounting vendors.
  • **NOT_FOUND**: the integration does not exist for this company, or the supplier has no accounting vendor yet.

Permissions Required​

  • accounting:import_vendor permission.
pullAccountingVendor(
  input: PullAccountingVendorInput!
): PullAccountingVendorPayload

Arguments​

pullAccountingVendor.input ● PullAccountingVendorInput! non-null input common​

Parameters for PullAccountingVendor

Type​

PullAccountingVendorPayload object common​

Autogenerated return type of PullAccountingVendor.