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

# Crear documento CXC

`POST /documento_cxc`

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.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/revisions/f390b90daf37/schema)