Documentos de cobro - Cobrix Docs

Cada documento pertenece a un source, un cliente y una moneda. Los campos terminados en Minor son enteros en unidades menores: 2000 representa USD 20,00.

collection_documents:readcollection_documents:write

Operaciones

Permiso del drawer	Scope	Método y ruta
Listar y consultar documentos	`collection_documents:read`	`GET /integrations/v1/{companyId}/collection-documents`
Listar y consultar documentos	`collection_documents:read`	`GET /integrations/v1/{companyId}/collection-documents/{externalDocumentId}`
Crear, actualizar y anular	`collection_documents:write`	`POST /integrations/v1/{companyId}/collection-documents/upsert`
Crear, actualizar y anular	`collection_documents:write`	`POST /integrations/v1/{companyId}/collection-documents/{externalDocumentId}/cancel`

Upsert
Lista
Detalle
Anulación

Envía source, externalDocumentId, customerExternalId, datos del cliente, fechas, moneda y líneas. totalMinor, si se incluye, debe ser coherente con las líneas.

Filtra por estado, cliente, documento, source, moneda, saldo, rangos de emisión o vencimiento y updatedSince. Usa cursor para continuar.

Orden recomendado de sincronización

Sincroniza el cliente

Ejecuta primero el upsert de Clientes con la misma pareja source + externalCustomerId.

Publica el documento

Conserva estable externalDocumentId y usa un Idempotency-Key único por intención de escritura.

Reconsulta el estado

Usa el detalle o updatedSince para confirmar saldo y evitar depender solo de la respuesta inicial.

Crea el link o reporta el pago

El documento abierto puede alimentar las categorías Links de cobro y Pagos.

Crear o actualizar

Revisa líneas, cliente embebido, fechas y validaciones monetarias.

Consultar documentos

Explora la paginación por cursor y todos los filtros soportados.

​Operaciones

​Orden recomendado de sincronización

Crear o actualizar

Consultar documentos

Operaciones

Orden recomendado de sincronización