Skip to main content
A Source is a named origin an Entity uses to group documents it pulls from external systems: for example, an SII feed, a supplier email inbox, or a CSV import. A Source is a bucket; the Source Feeds attached to it are what actually fetch data.
Open in the app. This resource has a page in the Sintropix web app at https://app.sintropix.com/{entityId}/sources/{sourceId}, where each id in braces is the same UUID as in the API route or response. Source configuration is at /{entityId}/settings/sources. When you mention a record to a user, include that link. See Link to the App for the full URL grammar.

Sources that hold Expense Renditions

An Expense Rendition (rendición) is an expense that a person of the Entity paid with their own money and reports for reimbursement, either through a tool such as Rindegastos or Xpendit or as an Expense Claim approved in Sintropix. Its Partner is the person who paid, not the merchant. Mark the Source of those documents as one that holds Expense Renditions (holdsExpenseRenditions: true). Every payable Invoice of a marked Source is an Expense Rendition:
  • In the app, it’s listed in Rendiciones (under Datos) instead of Compras, with its own totals and counts. Rendiciones has the filters and groupings of Compras except the ones that read a DTE: no document type or DTE columns, no DTE type, Standing, or Tax Period filter, and no grouping by DTE type or Tax Period. Nueva rendición submits an Expense Claim, which becomes an Expense Rendition when it’s approved. The Por aprobar and Rechazadas views list the claims that wait and the rejected ones.
  • In the API, its Invoice row carries isExpenseRendition: true, and GET /invoices/pages filters by it with isExpenseRendition.
  • The home dashboard counts it in expenseRenditionsToBook, not in purchasesToBook. See Home dashboard.
A receivable Invoice is never an Expense Rendition, whatever its Source. Sintropix reads the mark from the Source and never stores it on the Invoice. Unmark the Source and its Invoices go back to Compras right away, booked or not. In the app, turn on Fuente de rendiciones for the Source in Configuración → Fuentes, or when you create it. While an Entity’s Expense Claim setting names the Source, you can’t unmark it or delete it: Sintropix refuses both with 409 and SOURCE_PINNED_ERROR, with params.sourceId. Pick another Source in Configuración → Rendiciones first. The same holds while an expense Feed fills the Source: unmarking it answers 409 with SOURCE_PINNED_ERROR.

GET /sources

List every Source for the Entity, each annotated with the count of Invoices it has produced. Response: an array of Source objects.
Example response:

POST /sources

Create a Source. Body Response (201): the created Source object, with invoiceCount of 0.

PATCH /sources/:sourceId

Rename a Source, mark or unmark it as one that holds Expense Renditions, or both. Send at least one field. A field you omit keeps its value. An empty body is answered 400. Body Response: the updated Source object.
To mark a Source as one that holds Expense Renditions:

DELETE /sources/:sourceId

Delete a Source. A Source that existing Invoices name is refused with 409 and SOURCE_HAS_INVOICES_ERROR, with params.sourceId and params.invoiceCount. So is a Source the Expense Claim setting names, with 409 and SOURCE_PINNED_ERROR. Deleting a Source also deletes the Source Feed attached to it; the Integration stays connected. Response: the deleted Source object.

Status codes