Przejdź do treści

API versions

SaldeoSMART versions endpoints independently — document/list is at 2.12 while document/import is at 3.0. Every endpoint constant lives in src/saldeosmart_mcp/tools/endpoints.py, which is the only place in the codebase that knows API version numbers. Bumping a version is a one-line change there; see How to bump a Saldeo API version.

Total endpoints wrapped: 38 across 19 API versions.

By version

Version 1.0

Constant Endpoint
ASSURANCE_RENEW /api/xml/1.0/assurance/renew
CATEGORY_MERGE /api/xml/1.0/category/merge
COMPANY_LIST /api/xml/1.0/company/list
COMPANY_SYNCHRONIZE /api/xml/1.0/company/synchronize
DECLARATION_MERGE /api/xml/1.0/declaration/merge
DOCUMENT_ADD /api/xml/1.0/document/add
PAYMENT_METHOD_MERGE /api/xml/1.0/payment_method/merge
REGISTER_MERGE /api/xml/1.0/register/merge

Version 1.8

Constant Endpoint
DOCUMENT_SEARCH /api/xml/1.8/document/search

Version 1.12

Constant Endpoint
DIMENSION_MERGE /api/xml/1.12/dimension/merge

Version 1.13

Constant Endpoint
DESCRIPTION_MERGE /api/xml/1.13/description/merge
DOCUMENT_DELETE /api/xml/1.13/document/delete
DOCUMENT_SYNC /api/xml/1.13/document/sync
DOCUMENT_DIMENSION_MERGE /api/xml/1.13/document_dimension/merge
FEE_MERGE /api/xml/1.13/fee/merge

Version 1.14

Constant Endpoint
ARTICLE_MERGE /api/xml/1.14/article/merge

Version 1.15

Constant Endpoint
FINANCIAL_BALANCE_MERGE /api/xml/1.15/financial_balance/merge

Version 1.20

Constant Endpoint
DOCUMENT_RECOGNIZE /api/xml/1.20/document/recognize
INVOICE_LIST /api/xml/1.20/invoice/list

Version 1.23

Constant Endpoint
CONTRACTOR_LIST /api/xml/1.23/contractor/list
CONTRACTOR_MERGE /api/xml/1.23/contractor/merge

Version 2.0

Constant Endpoint
DOCUMENT_ADD_RECOGNIZE /api/xml/2.0/document/add_recognize

Version 2.4

Constant Endpoint
DOCUMENT_UPDATE /api/xml/2.4/document/update

Version 2.5

Constant Endpoint
DOCUMENT_CORRECT /api/xml/2.5/document/correct

Version 2.12

Constant Endpoint
DOCUMENT_LIST /api/xml/2.12/document/list

Version 2.18

Constant Endpoint
BANK_STATEMENT_LIST /api/xml/2.18/bank_statement/list
DOCUMENT_LIST_RECOGNIZED /api/xml/2.18/document/list_recognized

Version 2.19

Constant Endpoint
COMPANY_CREATE /api/xml/2.19/company/create

Version 2.20

Constant Endpoint
EMPLOYEE_LIST /api/xml/2.20/employee/list
PERSONNEL_DOCUMENT_LIST /api/xml/2.20/personnel_document/list

Version 2.21

Constant Endpoint
EMPLOYEE_ADD /api/xml/2.21/employee/add

Version 2.22

Constant Endpoint
PERSONNEL_DOCUMENT_ADD /api/xml/2.22/personnel_document/add

Version 3.0

Constant Endpoint
DOCUMENT_GET_ID_LIST /api/xml/3.0/document/getidlist
DOCUMENT_IMPORT /api/xml/3.0/document/import
DOCUMENT_LIST_BY_ID /api/xml/3.0/document/listbyid
INVOICE_GET_ID_LIST /api/xml/3.0/invoice/getidlist
INVOICE_LIST_BY_ID /api/xml/3.0/invoice/listbyid

Version 3.1

Constant Endpoint
INVOICE_ADD /api/xml/3.1/invoice/add

All endpoints

Constant Version Endpoint
ARTICLE_MERGE 1.14 /api/xml/1.14/article/merge
ASSURANCE_RENEW 1.0 /api/xml/1.0/assurance/renew
BANK_STATEMENT_LIST 2.18 /api/xml/2.18/bank_statement/list
CATEGORY_MERGE 1.0 /api/xml/1.0/category/merge
COMPANY_CREATE 2.19 /api/xml/2.19/company/create
COMPANY_LIST 1.0 /api/xml/1.0/company/list
COMPANY_SYNCHRONIZE 1.0 /api/xml/1.0/company/synchronize
CONTRACTOR_LIST 1.23 /api/xml/1.23/contractor/list
CONTRACTOR_MERGE 1.23 /api/xml/1.23/contractor/merge
DECLARATION_MERGE 1.0 /api/xml/1.0/declaration/merge
DESCRIPTION_MERGE 1.13 /api/xml/1.13/description/merge
DIMENSION_MERGE 1.12 /api/xml/1.12/dimension/merge
DOCUMENT_ADD 1.0 /api/xml/1.0/document/add
DOCUMENT_ADD_RECOGNIZE 2.0 /api/xml/2.0/document/add_recognize
DOCUMENT_CORRECT 2.5 /api/xml/2.5/document/correct
DOCUMENT_DELETE 1.13 /api/xml/1.13/document/delete
DOCUMENT_DIMENSION_MERGE 1.13 /api/xml/1.13/document_dimension/merge
DOCUMENT_GET_ID_LIST 3.0 /api/xml/3.0/document/getidlist
DOCUMENT_IMPORT 3.0 /api/xml/3.0/document/import
DOCUMENT_LIST 2.12 /api/xml/2.12/document/list
DOCUMENT_LIST_BY_ID 3.0 /api/xml/3.0/document/listbyid
DOCUMENT_LIST_RECOGNIZED 2.18 /api/xml/2.18/document/list_recognized
DOCUMENT_RECOGNIZE 1.20 /api/xml/1.20/document/recognize
DOCUMENT_SEARCH 1.8 /api/xml/1.8/document/search
DOCUMENT_SYNC 1.13 /api/xml/1.13/document/sync
DOCUMENT_UPDATE 2.4 /api/xml/2.4/document/update
EMPLOYEE_ADD 2.21 /api/xml/2.21/employee/add
EMPLOYEE_LIST 2.20 /api/xml/2.20/employee/list
FEE_MERGE 1.13 /api/xml/1.13/fee/merge
FINANCIAL_BALANCE_MERGE 1.15 /api/xml/1.15/financial_balance/merge
INVOICE_ADD 3.1 /api/xml/3.1/invoice/add
INVOICE_GET_ID_LIST 3.0 /api/xml/3.0/invoice/getidlist
INVOICE_LIST 1.20 /api/xml/1.20/invoice/list
INVOICE_LIST_BY_ID 3.0 /api/xml/3.0/invoice/listbyid
PAYMENT_METHOD_MERGE 1.0 /api/xml/1.0/payment_method/merge
PERSONNEL_DOCUMENT_ADD 2.22 /api/xml/2.22/personnel_document/add
PERSONNEL_DOCUMENT_LIST 2.20 /api/xml/2.20/personnel_document/list
REGISTER_MERGE 1.0 /api/xml/1.0/register/merge