---
title: "Crear Documento CXC"
method: POST
path: "/documento_cxc"
tags: ["Cuentas por Cobrar"]
---

# Crear Documento CXC

`POST /documento_cxc`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-enterprise`
- URL: `https://api.loggro.com/apik/loggro-enterprise/documento_cxc`
- Auth: HTTP bearer

El servicio está diseñado para recibir información destinada a la generación de documentos de cuentas por cobrar (CXC), ya sea de manera individual o en lote. Se permite enviar **un único documento** o **varios en un array**. Si alguno de los documentos falla en la validación, el sistema continuará procesando los demás y reportará los errores individualmente en la respuesta.

## Request body

- union
  - object
    - `control` string: Identificador del lote de importación
    - `total` number, double: Total del documento o factura.
    - `consecutivo` string, required: Número consecutivo del documento.
    - `tipoConsecutivo` string, required: Tipo de consecutivo del documento.
    - `tipoDocumento` string, required: Tipo de documento (Factura, Nota, etc.).
    - `claseDocumento` string, required: Clase contable del documento.
    - `division` string: División o área relacionada con el documento.
    - `tipoConsecutivoPedido` string: Tipo consecutivo del pedido asociado.
    - `consecutivoPedido` string: Consecutivo del pedido asociado.
    - `tipoConsecutivoAsociado` string: Tipo consecutivo del documento asociado.
    - `consecutivoAsociado` string: Consecutivo del documento asociado.
    - `cliente` string, required: Código del cliente asociado al documento.
    - `establecimientoCliente` string, required: Código del establecimiento del cliente.
    - `concepto` string: Código del concepto contable asociado.
    - `moneda` string, required: **Código de la moneda del documento.** Este valor puede ser consultado en el endpoint → [/consultarMoneda](https://developer.loggro.com/reference/consultarMoneda#/)
    - `tasaCambio` number, double: Tasa de cambio aplicada al documento.
    - `totalMonedaLocal` number, double: Total del documento expresado en moneda local.
    - `localizacion` string: Código de localización o sucursal.
    - `centroResponsabilidad` string: **Centro de responsabilidad contable asociado.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
    - `proyecto` string: Proyecto contable o financiero relacionado.
    - `comentario` string: Comentario o descripción general del documento.
    - `fechaExpedicion` string, dd/MM/yyyy, required: Fecha de expedición del documento (formato dd/MM/yyyy).
    - `fechaContabilizacion` string, dd/MM/yyyy, required: Fecha de contabilización del documento (formato dd/MM/yyyy).
    - `formaPago` string: **Forma de pago asociada al documento.** Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `fechaVencimiento` string, dd/MM/yyyy, required: Fecha de vencimiento del documento (formato dd/MM/yyyy).
    - `porcentajeDescuentoPiePagina` number, double: Porcentaje de descuento aplicado al total del documento.
    - `modalidad` string: Modalidad del documento (ej. E: electrónica).
    - `comentarioCorto` string: Comentario corto o referencia breve.
    - `vendedor` string: Código o nombre del vendedor asociado.
    - `cobrador` string: Código o nombre del cobrador asociado.
    - `transportadorMcia` string: Transportador de la mercancía.
    - `estabTransportadorMcia` string: Establecimiento del transportador.
    - `numeroGuia` string: Número de guía del transporte.
    - `placaVehiculo` string: Placa del vehículo transportador.
    - `lote` integer: Número de lote del documento.
    - `tipoFactura` string: Tipo de factura emitida.
    - `lineaProducto` string: Línea de producto o servicio.
    - `codigoDeduccionDescProntoPago` string: Código de deducción o descuento por pronto pago.
    - `tipoCliente` string: Tipo de cliente asociado.
    - `establecimiento` string: Código del establecimiento donde se genera el documento.
    - `actividadEconomica` string: **Código de la actividad económica.** Este valor puede ser consultado en el endpoint → [/consultarActividadEconomica](https://developer.loggro.com/reference/consultarActividadEconomica#/)
    - `tipoNota` string: Tipo de nota (crédito o débito).
    - `incoterm` string: Código Incoterm aplicable.
    - `avisoRecibo` string: Número de aviso de recibo.
    - `periodoAfectacionFiscal` integer: Periodo de afectación fiscal.
    - `anoAfectacionFiscal` integer: Año de afectación fiscal.
    - `ordenCompra` string: Número de orden de compra asociada.
    - `detallesDocumento` RecepcionDetalleDocumentoDatosEntrada[], required
      - `bienServicio` string: Código del bien o servicio asociado al detalle.
      - `concepto` string: Código del concepto asociado al detalle.
      - `descripcion` string: Descripción o nombre del bien o servicio.
      - `unidadVenta` string, required: Unidad de venta del artículo (por ejemplo: UN, KG, LT).
      - `cantidad` number, double: Cantidad del bien o servicio.
      - `precioUnitarioBruto` number, double: Precio unitario bruto antes de descuentos e impuestos.
      - `porcentajeDescArticulo` number, double: Porcentaje de descuento aplicado al artículo.
      - `lineaImpuesto` string: Código de la línea de impuesto aplicable.
      - `division` string: División o unidad operativa asociada.
      - `cuenta` string: **Cuenta contable asociada al detalle.** Este valor puede ser consultado en el endpoint → [/consultarCuentaContable](https://developer.loggro.com/reference/consultarCuentaContable#/)
      - `centroResponsabilidadCuenta` string: **Centro de responsabilidad de la cuenta.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
      - `conceptoCuenta` string: **Concepto contable asociado a la cuenta.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
      - `terceroCuenta` string: Código del tercero asociado a la cuenta contable.
      - `documentoCuenta` string: Documento de referencia asociado a la cuenta.
      - `fechaVencimiento` string, dd/MM/yyyy: Fecha de vencimiento del documento o ítem.
      - `diasDiferido` string: Cantidad de días diferidos aplicados al detalle.
      - `fechaDiferido` string, dd/MM/yyyy: Fecha en la que inicia o aplica el diferido.
      - `proyecto` string: Código del proyecto asociado al detalle.
      - `baseDescuentoProntoPago` 'S' | 'N': Indica si aplica base de descuento por pronto pago.
      - `localizacion` string: Código de localización o sucursal relacionada con el detalle.
      - `conceptoICA` string: Código del concepto ICA aplicado al detalle.
      - `tipoConsecutivoAsociado` string: Tipo de consecutivo del documento asociado.
      - `consecutivoAsociado` string: Número consecutivo del documento asociado.
      - `comentario` string: Comentario u observación adicional del detalle.
      - `remesa` 'S' | 'N': Indica si el detalle está asociado a una remesa.
      - `radicadoRemesa` integer: Número de radicado de la remesa asociada.
      - `consecutivoRemesa` string: Consecutivo de la remesa asociada.
      - `totalRemesa` number, double: Total asociado a la remesa.
      - `cantidadRemesa` number, double: Cantidad total incluida en la remesa.
      - `unidadMedidaRemesa` string: Unidad de medida utilizada en la remesa.
      - `valorDescuentoArticulo` number, double: Valor de descuento por articulo del detalle.
    - `cargosDocumento` RecepcionCargosDocumentoDatosEntrada[]
      - `codigoCargo` string, required: Código del cargo aplicado al documento.
      - `valor` number, double: Valor monetario del cargo.
      - `lineaImpuesto` string: Código de la línea de impuesto asociada al cargo.
      - `division` string: División o unidad organizacional a la que pertenece el cargo.
      - `diasDiferido` string: Número de días de diferido aplicables al cargo.
      - `fechaDiferido` string, dd/MM/yyyy: Fecha en la que aplica el diferido del cargo.
  - RecepcionDocumentoDatosEntrada[]
    - `control` string: Identificador del lote de importación
    - `total` number, double: Total del documento o factura.
    - `consecutivo` string, required: Número consecutivo del documento.
    - `tipoConsecutivo` string, required: Tipo de consecutivo del documento.
    - `tipoDocumento` string, required: Tipo de documento (Factura, Nota, etc.).
    - `claseDocumento` string, required: Clase contable del documento.
    - `division` string: División o área relacionada con el documento.
    - `tipoConsecutivoPedido` string: Tipo consecutivo del pedido asociado.
    - `consecutivoPedido` string: Consecutivo del pedido asociado.
    - `tipoConsecutivoAsociado` string: Tipo consecutivo del documento asociado.
    - `consecutivoAsociado` string: Consecutivo del documento asociado.
    - `cliente` string, required: Código del cliente asociado al documento.
    - `establecimientoCliente` string, required: Código del establecimiento del cliente.
    - `concepto` string: Código del concepto contable asociado.
    - `moneda` string, required: **Código de la moneda del documento.** Este valor puede ser consultado en el endpoint → [/consultarMoneda](https://developer.loggro.com/reference/consultarMoneda#/)
    - `tasaCambio` number, double: Tasa de cambio aplicada al documento.
    - `totalMonedaLocal` number, double: Total del documento expresado en moneda local.
    - `localizacion` string: Código de localización o sucursal.
    - `centroResponsabilidad` string: **Centro de responsabilidad contable asociado.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
    - `proyecto` string: Proyecto contable o financiero relacionado.
    - `comentario` string: Comentario o descripción general del documento.
    - `fechaExpedicion` string, dd/MM/yyyy, required: Fecha de expedición del documento (formato dd/MM/yyyy).
    - `fechaContabilizacion` string, dd/MM/yyyy, required: Fecha de contabilización del documento (formato dd/MM/yyyy).
    - `formaPago` string: **Forma de pago asociada al documento.** Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `fechaVencimiento` string, dd/MM/yyyy, required: Fecha de vencimiento del documento (formato dd/MM/yyyy).
    - `porcentajeDescuentoPiePagina` number, double: Porcentaje de descuento aplicado al total del documento.
    - `modalidad` string: Modalidad del documento (ej. E: electrónica).
    - `comentarioCorto` string: Comentario corto o referencia breve.
    - `vendedor` string: Código o nombre del vendedor asociado.
    - `cobrador` string: Código o nombre del cobrador asociado.
    - `transportadorMcia` string: Transportador de la mercancía.
    - `estabTransportadorMcia` string: Establecimiento del transportador.
    - `numeroGuia` string: Número de guía del transporte.
    - `placaVehiculo` string: Placa del vehículo transportador.
    - `lote` integer: Número de lote del documento.
    - `tipoFactura` string: Tipo de factura emitida.
    - `lineaProducto` string: Línea de producto o servicio.
    - `codigoDeduccionDescProntoPago` string: Código de deducción o descuento por pronto pago.
    - `tipoCliente` string: Tipo de cliente asociado.
    - `establecimiento` string: Código del establecimiento donde se genera el documento.
    - `actividadEconomica` string: **Código de la actividad económica.** Este valor puede ser consultado en el endpoint → [/consultarActividadEconomica](https://developer.loggro.com/reference/consultarActividadEconomica#/)
    - `tipoNota` string: Tipo de nota (crédito o débito).
    - `incoterm` string: Código Incoterm aplicable.
    - `avisoRecibo` string: Número de aviso de recibo.
    - `periodoAfectacionFiscal` integer: Periodo de afectación fiscal.
    - `anoAfectacionFiscal` integer: Año de afectación fiscal.
    - `ordenCompra` string: Número de orden de compra asociada.
    - `detallesDocumento` RecepcionDetalleDocumentoDatosEntrada[], required
      - `bienServicio` string: Código del bien o servicio asociado al detalle.
      - `concepto` string: Código del concepto asociado al detalle.
      - `descripcion` string: Descripción o nombre del bien o servicio.
      - `unidadVenta` string, required: Unidad de venta del artículo (por ejemplo: UN, KG, LT).
      - `cantidad` number, double: Cantidad del bien o servicio.
      - `precioUnitarioBruto` number, double: Precio unitario bruto antes de descuentos e impuestos.
      - `porcentajeDescArticulo` number, double: Porcentaje de descuento aplicado al artículo.
      - `lineaImpuesto` string: Código de la línea de impuesto aplicable.
      - `division` string: División o unidad operativa asociada.
      - `cuenta` string: **Cuenta contable asociada al detalle.** Este valor puede ser consultado en el endpoint → [/consultarCuentaContable](https://developer.loggro.com/reference/consultarCuentaContable#/)
      - `centroResponsabilidadCuenta` string: **Centro de responsabilidad de la cuenta.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
      - `conceptoCuenta` string: **Concepto contable asociado a la cuenta.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
      - `terceroCuenta` string: Código del tercero asociado a la cuenta contable.
      - `documentoCuenta` string: Documento de referencia asociado a la cuenta.
      - `fechaVencimiento` string, dd/MM/yyyy: Fecha de vencimiento del documento o ítem.
      - `diasDiferido` string: Cantidad de días diferidos aplicados al detalle.
      - `fechaDiferido` string, dd/MM/yyyy: Fecha en la que inicia o aplica el diferido.
      - `proyecto` string: Código del proyecto asociado al detalle.
      - `baseDescuentoProntoPago` 'S' | 'N': Indica si aplica base de descuento por pronto pago.
      - `localizacion` string: Código de localización o sucursal relacionada con el detalle.
      - `conceptoICA` string: Código del concepto ICA aplicado al detalle.
      - `tipoConsecutivoAsociado` string: Tipo de consecutivo del documento asociado.
      - `consecutivoAsociado` string: Número consecutivo del documento asociado.
      - `comentario` string: Comentario u observación adicional del detalle.
      - `remesa` 'S' | 'N': Indica si el detalle está asociado a una remesa.
      - `radicadoRemesa` integer: Número de radicado de la remesa asociada.
      - `consecutivoRemesa` string: Consecutivo de la remesa asociada.
      - `totalRemesa` number, double: Total asociado a la remesa.
      - `cantidadRemesa` number, double: Cantidad total incluida en la remesa.
      - `unidadMedidaRemesa` string: Unidad de medida utilizada en la remesa.
      - `valorDescuentoArticulo` number, double: Valor de descuento por articulo del detalle.
    - `cargosDocumento` RecepcionCargosDocumentoDatosEntrada[]
      - `codigoCargo` string, required: Código del cargo aplicado al documento.
      - `valor` number, double: Valor monetario del cargo.
      - `lineaImpuesto` string: Código de la línea de impuesto asociada al cargo.
      - `division` string: División o unidad organizacional a la que pertenece el cargo.
      - `diasDiferido` string: Número de días de diferido aplicables al cargo.
      - `fechaDiferido` string, dd/MM/yyyy: Fecha en la que aplica el diferido del cargo.

## Response `201`

Todos los documentos fueron creados correctamente

- RespuestaImportacion[]
  - `identificacion` string
  - `operacionExitosa` boolean
  - `mensaje` string

## Other responses

- `400`: Error en la validación o al menos un documento falló en la creación
- `404`: Recurso no encontrado
- `500`: Error interno inesperado en el servidor

---

[API](https://skmtc.dev/loggro/apis/enterprise-api-s.md) - [All operations](https://skmtc.dev/loggro/apis/enterprise-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/enterprise-api-s/revisions/933dac40ea9c?raw)