Contractors¶

Suppliers and customers attached to a company.

Read tools¶

Tool	Summary
`list_contractors`	List contractors (suppliers and customers) for a specific company.

Mutates customer data

Calls under this heading change the SaldeoSMART account. Confirm intent before invoking from an autonomous agent.

Tool	Summary
`merge_contractors`	Create or update contractors (suppliers/customers) in bulk.

list_contractors(company_program_id: str) -> ContractorList | ErrorResponse

List contractors (suppliers and customers) for a specific company.

Parameters:

Name	Type	Description	Default
`company_program_id`	`str`	External program ID of the company. Required. Get one from list_companies first if you don't know it.	required

merge_contractors(company_program_id: str, contractors: list[ContractorInput]) -> MergeResult | ErrorResponse

Create or update contractors (suppliers/customers) in bulk.

Saldeo op: contractor.merge (SS02). Saldeo returns per-item statuses — failed-validation fields surface in errors.

Parameters:

Name	Type	Description	Default
`company_program_id`	`str`	External program ID of the company.	required
`contractors`	`list[ContractorInput]`	One ContractorInput per contractor. Required on every entry: `short_name`, `full_name`. Identification rule (controls create vs update): - Provide `contractor_program_id` — your ERP-side ID, used when integrating with an external system. Use this when you already track the contractor in your ERP. - Provide `contractor_id` — Saldeo's internal numeric ID, returned by `list_contractors`. Use this when you've already pulled the contractor from Saldeo and want to update it. - Omit both — a brand-new contractor is created.	required

Returns:

Type	Description
`MergeResult \| ErrorResponse`	MergeResult on success, ErrorResponse on failure.