> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentos de cobro

> Sincroniza cuentas por cobrar con importes en unidades menores

<div className="cobrix-category">
  <strong>La cartera operativa del sistema externo dentro de Cobrix.</strong>
  <p>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.</p>
</div>

<div className="cobrix-scope-line">
  <span className="cobrix-scope">collection\_documents:read</span>
  <span className="cobrix-scope">collection\_documents:write</span>
</div>

## 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` |

<Tabs>
  <Tab title="Upsert">
    Envía `source`, `externalDocumentId`, `customerExternalId`, datos del cliente, fechas, moneda y líneas. `totalMinor`, si se incluye, debe ser coherente con las líneas.
  </Tab>

  <Tab title="Lista">
    Filtra por estado, cliente, documento, source, moneda, saldo, rangos de emisión o vencimiento y `updatedSince`. Usa `cursor` para continuar.
  </Tab>

  <Tab title="Detalle">
    Consulta saldos, líneas, aplicaciones y estado operativo usando el identificador externo del documento.
  </Tab>

  <Tab title="Anulación">
    La anulación es auditada e idempotente. Si el documento tiene aplicaciones incompatibles, Cobrix responde conflicto para conservar el ledger.
  </Tab>
</Tabs>

## Orden recomendado de sincronización

<Steps>
  <Step title="Sincroniza el cliente">
    Ejecuta primero el upsert de Clientes con la misma pareja `source` + `externalCustomerId`.
  </Step>

  <Step title="Publica el documento">
    Conserva estable `externalDocumentId` y usa un `Idempotency-Key` único por intención de escritura.
  </Step>

  <Step title="Reconsulta el estado">
    Usa el detalle o `updatedSince` para confirmar saldo y evitar depender solo de la respuesta inicial.
  </Step>

  <Step title="Crea el link o reporta el pago">
    El documento abierto puede alimentar las categorías Links de cobro y Pagos.
  </Step>
</Steps>

<Columns cols={2}>
  <Card title="Crear o actualizar" icon="file-circle-plus" href="/api-reference/documentos-de-cobro/crear-o-actualizar-documento" cta="Ver contrato" arrow>
    Revisa líneas, cliente embebido, fechas y validaciones monetarias.
  </Card>

  <Card title="Consultar documentos" icon="filter" href="/api-reference/documentos-de-cobro/listar-documentos" cta="Ver filtros" arrow>
    Explora la paginación por cursor y todos los filtros soportados.
  </Card>
</Columns>