Invoices¶

Sales invoices issued in SaldeoSMART.

Read tools¶

Tool	Summary
`get_invoice_id_list`	List invoice IDs in one folder, grouped by kind (SSK07).
`get_invoices_by_id`	Fetch full sales-invoice records for a set of IDs, grouped by kind.
`list_invoices`	List sales invoices issued in SaldeoSMART (only those marked for export).

Write tools¶

Mutates customer data

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

Tool	Summary
`add_invoice`	Issue a new sales invoice in SaldeoSMART (3.1, SSK06).

API reference¶

add_invoice ¶

add_invoice(company_program_id: str, invoice: InvoiceAddInput) -> MergeResult | ErrorResponse

Issue a new sales invoice in SaldeoSMART (3.1, SSK06).

Creates one invoice with up to 10000 line items, optional payments, and optional new-transport-vehicle metadata. Saldeo answers per-record with CREATED (success) or NOT_VALID / ERROR. No file attachments — SaldeoSMART generates the printable PDF on its side from the structured invoice data.

get_invoice_id_list ¶

get_invoice_id_list(company_program_id: str, year: Year, month: Month) -> InvoiceIdGroups | ErrorResponse

List invoice IDs in one folder, grouped by kind (SSK07).

Buckets: invoices, corrective_invoices, pre_invoices, corrective_pre_invoices. Pair with get_invoices_by_id to fetch the records.

get_invoices_by_id ¶

get_invoices_by_id(company_program_id: str, invoices: list[int] | None = None, corrective_invoices: list[int] | None = None, pre_invoices: list[int] | None = None, corrective_pre_invoices: list[int] | None = None) -> InvoiceList | ErrorResponse

Fetch full sales-invoice records for a set of IDs, grouped by kind.

Pair with get_invoice_id_list for paginated browsing of one folder. Saldeo op: invoice.listbyid (3.0).

Parameters:

Name	Type	Description	Default
`company_program_id`	`str`	External program ID of the company.	required
`invoices`	`list[int] \| None`	Optional list of invoice IDs from `get_invoice_id_list`.	`None`
`corrective_invoices`	`list[int] \| None`	Optional list of corrective-invoice IDs.	`None`
`pre_invoices`	`list[int] \| None`	Optional list of pre-invoice IDs.	`None`
`corrective_pre_invoices`	`list[int] \| None`	Optional list of corrective-pre-invoice IDs. Pass only the buckets you care about; the rest default to None (omitted from the request).	`None`

Returns:

Type	Description
`InvoiceList \| ErrorResponse`	InvoiceList — flat list of invoice records.

list_invoices ¶

list_invoices(company_program_id: str) -> InvoiceList | ErrorResponse

List sales invoices issued in SaldeoSMART (only those marked for export).

This is for invoices CREATED in SaldeoSMART (the invoicing module), not OCR-processed cost documents — for those use list_documents.