Receivables

A receivable is any document that represents debt or modifies it on a receivable account: invoices, credit notes, merchandise returns, retentions, adjustments. It is the unit with which the customer records what is expected to be collected (or no longer owed) from each client.

Receivable is not an AFIP voucher nor a movement

The receivable is an accounting record within Max Pay, not the AFIP voucher itself. Voucher data (legalNumber, pointOfSale, authCode, etc.) is optional and referential. It is also not a money movement: incoming money is recorded as a separate movement, with no automatic link to the receivable. See Lifecycle.

Pages

• How to create receivables — single and batch flows.
• Lifecycle and states — what transitions exist and when they occur.
• Credit notes and adjustments — receivables linked to others.

Model

{
  "id": 99001,
  "receivableAccountId": 4242,
  "clientId": 1042,
  "associateId": null,
  "amount": 45000.00,
  "currencyCode": "ARS",
  "receivableType": "INVOICE",
  "status": "PENDING",
  "legalNumber": "0001-00012345",
  "description": "Order 5678 - 12 boxes",
  "externalRoutingCode": null,
  "issueDate": "2026-05-15",
  "dueDate": "2026-05-30",
  "receivableDate": "2026-05-15",
  "parentReceivableId": null,
  "attachmentUri": null,

  "invoiceData": {
    "version": "1",
    "pointOfSale": "0001",
    "quote": "12345",
    "rawDocumentType": "FA",
    "recipientDocumentType": "CUIT",
    "authCodeType": "CAE",
    "authCode": "70123456789012"
  },

  "creationDate": "2026-05-15T10:00:00-03:00",
  "modificationDate": "2026-05-15T10:00:00-03:00"
}

Main fields

Field	Type	Description
id	int64	Unique receivable identifier.
receivableAccountId	int64	Receivable account on which it is issued.
clientId	int64	Client. Inherited from the account if not specified.
associateId	int64	Operator registering the receivable (optional). If specified and the account has no associate, post-hoc binds the associate to the account. See post-hoc binding.
amount	decimal	Notice amount. Always positive. The accounting sign comes from the receivableType.
currencyCode	string	Must match the account currency. Today always ARS.
receivableType	enum	See table below. Defines whether it adds or subtracts debt.
status	enum	See Lifecycle.
legalNumber	string	Voucher number. Unique per customer when provided: reusing an existing legalNumber returns 409 duplicated-legal-number.
description	string	Free-form description of the receivable.
externalRoutingCode	string	Operational route code (e.g. driver's route sheet).
issueDate	YYYY-MM-DD	Issue date of the voucher.
dueDate	YYYY-MM-DD	Due date.
receivableDate	YYYY-MM-DD	Date the receivable is registered in the system.
parentReceivableId	int64	If this receivable is linked to another (typical: credit notes). See Credit notes.
attachmentUri	string	URL to the attached voucher.
invoiceData	object	AFIP voucher data (CAE, point of sale, etc.). Optional.

Receivable types

receivableType	Accounting sign	Description
INVOICE	+ (adds debt)	Invoice
DEBT	+	Non-fiscal debt (debit note, balance reinforcement)
CREDIT_NOTE	- (reduces debt)	AFIP credit note
MISSING_PRODUCT	-	Missing merchandise
RETURN_PRODUCT	-	Returned merchandise
BROKEN_PRODUCT	-	Broken merchandise
ADJUSTMENT	-	Favorable adjustment for the client
RETENTION	-	Tax retention by client

Negative receivables must link to a parent

CREDIT_NOTE, MISSING_PRODUCT, RETURN_PRODUCT, BROKEN_PRODUCT, ADJUSTMENT and RETENTION are always issued against a previous positive receivable, identified in parentReceivableId. See Credit notes.

Endpoints

Method	Path	Description
GET	/v1/receivables	List cross-account with filters
POST	/v1/receivables	Create one
POST	/v1/receivables/batches	Bulk create
GET	/v1/receivables/{id}	Detail
PUT	/v1/receivables/{id}	Update editable fields
PATCH	/v1/receivables/{id}/status	Change status (e.g. mark as PAID). See Lifecycle
GET	/v1/receivable-accounts/{id}/receivables	Receivables of a specific account

Listing filters

GET /v1/receivables

Parameter	Type	Description
receivableAccountId	int64	Specific account
clientId	int64	Client
associateId	int64	Operator
status	enum	PENDING, PAID, SETTLED, EXPIRED, DISABLED
receivableType	enum	Filter by type
fromDate, toDate	ISO 8601	Range by receivable creation date (toDate inclusive). E.g. 2026-05-01T00:00:00-03:00
fromDueDate, toDueDate	YYYY-MM-DD	Due date range
fromIssueDate, toIssueDate	YYYY-MM-DD	Issue date range
legalNumber	string	Voucher number
externalRoutingCode	string	Route code
parentReceivableId	int64	Children of a receivable (e.g. all credit notes linked to it)
minAmount, maxAmount	decimal	Amount range
page, count	int	Pagination