Comprobantes

Un comprobante es cualquier documento que representa deuda o la modifica sobre una cuenta recaudadora: facturas, notas de crédito, devoluciones de mercadería, retenciones, ajustes. Es la unidad con la que el customer registra qué espera cobrar (o qué ya no se debe cobrar) de cada cliente.

El comprobante de Max Pay no es el comprobante AFIP ni un movimiento

El comprobante es un registro contable dentro de Max Pay, no el comprobante AFIP en sí. Los datos del comprobante AFIP (legalNumber, pointOfSale, authCode, etc.) son opcionales y referenciales. Tampoco es un movimiento de dinero: la llegada de plata se registra como movement por separado, sin vínculo automático al comprobante. Ver Lifecycle.

Páginas

• Cómo crear comprobantes — flujo único y batch.
• Lifecycle y estados — qué transiciones existen y cuándo ocurren.
• Notas de crédito y ajustes — comprobantes vinculados a otros.

Modelo

{
  "id": 99001,
  "receivableAccountId": 4242,
  "clientId": 1042,
  "associateId": null,
  "amount": 45000.00,
  "currencyCode": "ARS",
  "receivableType": "INVOICE",
  "status": "PENDING",
  "legalNumber": "0001-00012345",
  "description": "Pedido 5678 - 12 cajas",
  "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"
}

Campos principales

Campo	Tipo	Descripción
id	int64	Identificador único del comprobante.
receivableAccountId	int64	Cuenta recaudadora sobre la cual se emite.
clientId	int64	Cliente. Heredado de la cuenta si no se especifica.
associateId	int64	Operador que registra el comprobante (opcional). Si se especifica y la cuenta no tiene asociado, vincula post-hoc al asociado a la cuenta. Ver vinculación post-hoc.
amount	decimal	Monto del comprobante. Positivo siempre. El signo contable lo da el receivableType.
currencyCode	string	Debe coincidir con la moneda de la cuenta. Hoy siempre ARS.
receivableType	enum	Ver tabla abajo. Define si suma o resta deuda.
status	enum	Ver Lifecycle.
legalNumber	string	Número del comprobante. Único por customer cuando se envía: repetir un legalNumber ya usado devuelve 409 duplicated-legal-number.
description	string	Descripción libre del comprobante.
externalRoutingCode	string	Código de ruta operativo (ej. hoja de ruta del chofer).
issueDate	YYYY-MM-DD	Fecha de emisión del comprobante.
dueDate	YYYY-MM-DD	Fecha de vencimiento.
receivableDate	YYYY-MM-DD	Fecha en que el comprobante se registra en el sistema.
parentReceivableId	int64	Si este comprobante está vinculado a otro (típico: notas de crédito). Ver Notas de crédito.
attachmentUri	string	URL al comprobante adjunto.
invoiceData	object	Datos del comprobante AFIP (CAE, punto de venta, etc.). Opcionales.

Tipos de comprobante

receivableType	Signo contable	Descripción
INVOICE	+ (suma deuda)	Factura
DEBT	+	Otro tipo de deuda no fiscal (nota de débito, refuerzo de saldo)
CREDIT_NOTE	- (resta deuda)	Nota de crédito de AFIP
MISSING_PRODUCT	-	Faltante de mercadería
RETURN_PRODUCT	-	Devolución de mercadería
BROKEN_PRODUCT	-	Rotura de mercadería
ADJUSTMENT	-	Ajuste a favor del cliente
RETENTION	-	Retención impositiva aplicada por el cliente

Los comprobantes con signo negativo necesitan vincular a un padre

CREDIT_NOTE, MISSING_PRODUCT, RETURN_PRODUCT, BROKEN_PRODUCT, ADJUSTMENT y RETENTION se emiten siempre contra un comprobante positivo previo, identificado en parentReceivableId. Ver Notas de crédito.

Endpoints

Método	Path	Descripción
GET	/v1/receivables	Lista cross-cuenta con filtros
POST	/v1/receivables	Crea uno
POST	/v1/receivables/batches	Crea masivamente
GET	/v1/receivables/{id}	Detalle
PUT	/v1/receivables/{id}	Actualiza campos editables
PATCH	/v1/receivables/{id}/status	Cambia status (ej. marcar como PAID). Ver Lifecycle
GET	/v1/receivable-accounts/{id}/receivables	Comprobantes de una cuenta puntual

Filtros del listado

GET /v1/receivables

Parámetro	Tipo	Descripción
receivableAccountId	int64	Cuenta puntual
clientId	int64	Cliente
associateId	int64	Operador
status	enum	PENDING, PAID, SETTLED, EXPIRED, DISABLED
receivableType	enum	Filtrar por tipo
fromDate, toDate	ISO 8601	Rango por fecha de creación del comprobante (toDate inclusive). Ej: 2026-05-01T00:00:00-03:00
fromDueDate, toDueDate	YYYY-MM-DD	Rango de vencimiento
fromIssueDate, toIssueDate	YYYY-MM-DD	Rango de emisión
legalNumber	string	Número de comprobante
externalRoutingCode	string	Código de ruta
parentReceivableId	int64	Hijos de un comprobante (ej. todas las notas de crédito asociadas)
minAmount, maxAmount	decimal	Rango de monto
page, count	int	Paginación