---
title: "Crear documento CXP"
method: POST
path: "/documento_cxp"
tags: ["Cuentas por Pagar"]
---

# Crear documento CXP

`POST /documento_cxp`

El servicio está diseñado para recibir información destinada a la generación de documentos del proveedor, 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
    - `division` string — División del encabezado del documento.
    - `total` number, double, required — Total del documento.
    - `consecutivo` string, required — Consecutivo del documento.
    - `tipoConsecutivo` string, required — Tipo de consecutivo del documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tipos de consecutivo)
    - `lote` integer — Número de lote del documento.
    - `tipoDocumento` string, required — Tipo de documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tipos de documento/Tipos de documento)
    - `claseDocumento` string, required — Clase del documento. Las clases son: FACO para facturas, NCCO para notas crédito, NDCO para notas crédito, SACO para solicitudes de anticipo, ANCO para anticipos y SPCO para solicitudes de pago.
    - `numero` string, required — Número de documento del proveedor.
    - `proveedor` string, required — Identificación del proveedor.
    - `establecimientoProveedor` string, required — Sucursal del proveedor a la que pertenece el documento.
    - `concepto` string — Concepto asociado al documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Conceptos de los documentos/Compra)
    - `tipoConsOrdenCompra` string — Tipo de consecutivo de la orden de compra.
    - `consOrdenCompra` string — Consecutivo de la orden de compra.
    - `tipoConsecutivoAsociado` string — Tipo de consecutivo del documento asociado.
    - `consecutivoAsociado` string — Consecutivo del documento 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, required — Tasa de cambio del documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tasas de Cambio)
    - `fechaExpedicion` string, required — Fecha de expedición del documento en formato dd/MM/yyyy.
    - `fechaRecepcion` string, required — Fecha de recepción del documento en formato dd/MM/yyyy.
    - `fechaVencimiento` string, required — Fecha de vencimiento del documento en formato dd/MM/yyyy.
    - `localizacion` string — Ubicación en bodega del bien/servicio.
    - `centroResponsabilidad` string — **Código del centro de responsabilidad donde debe quedar consignado contablemente el documento.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
    - `proyecto` string — Número del proyecto u obra a la que pertenece el documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Proyectos/Definicion de proyectos)
    - `comentarioCorto` string — Comentario corto del documento.
    - `comentario` string — Comentario general del documento.
    - `formaPago` string — **Código de la forma de pago.** Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `porcentajeDescuentoPiePagina` number, double — Porcentaje de descuento aplicado en el pie de página.
    - `prioridad` string — Clasificación del pago al proveedor así: Alta, Media, Baja.
    - `conceptoCuenta` string — **Concepto de la cuenta contable asociada.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
    - `terceroCuenta` string — Identificación del tercero en la cuenta.
    - `documentoCuenta` string — Número del documento contable asociado.
    - `fechaContabilizacion` string, required — Fecha de contabilización en formato dd/MM/yyyy.
    - `suministrador` string — Identificacion del suministrador del bien o servicio.
    - `prefijo` string — Prefijo del documento.
    - `tipoProveedor` string — **Código del tipo de proveedor.** Este valor puede ser consultado en el endpoint → [/consultarTipoProveedor](https://developer.loggro.com/reference/consultarTipoProveedor#/)
    - `tipoNota` string — Tipo de nota del documento.
    - `detallesDocumento` RecepcionDetalleDocumentoCXPDatosEntrada[], required — Lista con los detalles del documento.
      - `bienServicio` string — Bien o servicio del detalle
      - `descripcion` string — Descripción del detalle
      - `unidadVenta` string, required — Unidad de venta del detalle
      - `cantidad` number, double — Cantidad del producto o servicio
      - `precioUnitarioBruto` number, double — Precio unitario bruto
      - `porcentajeDescuento` number, double — Porcentaje de descuento aplicado
      - `concepto` string — Código del concepto asociado al detalle
      - `lineaImpuesto` string — Código de línea de impuesto
      - `division` string — División asociada al detalle
      - `cuenta` string — **Cuenta contable del detalle.** Este valor puede ser consultado en el endpoint → [/consultarCuentaContable](https://developer.loggro.com/reference/consultarCuentaContable#/)
      - `centroResponsabilidadCuenta` string — **Centro de responsabilidad de la cuenta detalle.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
      - `conceptoCuenta` string — **Concepto asociado a la cuenta detalle.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
      - `terceroCuenta` string — Tercero asociado a la cuenta detalle
      - `documentoCuenta` string — Documento asociado a la cuenta detalle
      - `fechaVencimiento` string — Fecha de vencimiento en formato dd/MM/yyyy
      - `diasDiferido` string — Número de días diferidos
      - `fechaDiferido` string — Fecha diferido en formato dd/MM/yyyy
      - `proyecto` string — Proyecto asociado al detalle
      - `baseDescuentoProntoPago` 'S' | 'N' — Indica si aplica descuento por pronto pago. Valores permitidos: S=Sí, N=No
      - `localizacion` string — Localización asociada al detalle
      - `conceptoIVA` string — Concepto de IVA del detalle
      - `conceptoICA` string — Concepto de ICA del detalle
      - `conceptoTIMBRE` string — Concepto de TIMBRE del detalle
      - `conceptoRIE` string — Concepto de RIE del detalle
    - `cargosDocumento` RecepcionCargosDocumentoCXPDatosEntrada[] — Lista de cargos asociados al documento.
      - `codigoCargo` string, required — Código del cargo asociado al documento.
      - `valor` number, double — Valor del cargo aplicado al documento.
      - `tipoDistribucion` 'S' | 'N' — ¿El cargo está distribuido?.
      - `lineaImpuesto` string — Código de la línea de impuesto asociada al cargo.
      - `conceptoICA` string — Código del concepto ICA aplicado al cargo.
      - `conceptoRIE` string — Código del concepto RIE aplicado al cargo.
  - RecepcionDocumentoCXPDatosEntrada[]
    - `division` string — División del encabezado del documento.
    - `total` number, double, required — Total del documento.
    - `consecutivo` string, required — Consecutivo del documento.
    - `tipoConsecutivo` string, required — Tipo de consecutivo del documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tipos de consecutivo)
    - `lote` integer — Número de lote del documento.
    - `tipoDocumento` string, required — Tipo de documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tipos de documento/Tipos de documento)
    - `claseDocumento` string, required — Clase del documento. Las clases son: FACO para facturas, NCCO para notas crédito, NDCO para notas crédito, SACO para solicitudes de anticipo, ANCO para anticipos y SPCO para solicitudes de pago.
    - `numero` string, required — Número de documento del proveedor.
    - `proveedor` string, required — Identificación del proveedor.
    - `establecimientoProveedor` string, required — Sucursal del proveedor a la que pertenece el documento.
    - `concepto` string — Concepto asociado al documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Conceptos de los documentos/Compra)
    - `tipoConsOrdenCompra` string — Tipo de consecutivo de la orden de compra.
    - `consOrdenCompra` string — Consecutivo de la orden de compra.
    - `tipoConsecutivoAsociado` string — Tipo de consecutivo del documento asociado.
    - `consecutivoAsociado` string — Consecutivo del documento 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, required — Tasa de cambio del documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Tasas de Cambio)
    - `fechaExpedicion` string, required — Fecha de expedición del documento en formato dd/MM/yyyy.
    - `fechaRecepcion` string, required — Fecha de recepción del documento en formato dd/MM/yyyy.
    - `fechaVencimiento` string, required — Fecha de vencimiento del documento en formato dd/MM/yyyy.
    - `localizacion` string — Ubicación en bodega del bien/servicio.
    - `centroResponsabilidad` string — **Código del centro de responsabilidad donde debe quedar consignado contablemente el documento.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
    - `proyecto` string — Número del proyecto u obra a la que pertenece el documento. Este valor puede ser consultado en el ERP (Archivos/Comunes/Proyectos/Definicion de proyectos)
    - `comentarioCorto` string — Comentario corto del documento.
    - `comentario` string — Comentario general del documento.
    - `formaPago` string — **Código de la forma de pago.** Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `porcentajeDescuentoPiePagina` number, double — Porcentaje de descuento aplicado en el pie de página.
    - `prioridad` string — Clasificación del pago al proveedor así: Alta, Media, Baja.
    - `conceptoCuenta` string — **Concepto de la cuenta contable asociada.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
    - `terceroCuenta` string — Identificación del tercero en la cuenta.
    - `documentoCuenta` string — Número del documento contable asociado.
    - `fechaContabilizacion` string, required — Fecha de contabilización en formato dd/MM/yyyy.
    - `suministrador` string — Identificacion del suministrador del bien o servicio.
    - `prefijo` string — Prefijo del documento.
    - `tipoProveedor` string — **Código del tipo de proveedor.** Este valor puede ser consultado en el endpoint → [/consultarTipoProveedor](https://developer.loggro.com/reference/consultarTipoProveedor#/)
    - `tipoNota` string — Tipo de nota del documento.
    - `detallesDocumento` RecepcionDetalleDocumentoCXPDatosEntrada[], required — Lista con los detalles del documento.
      - `bienServicio` string — Bien o servicio del detalle
      - `descripcion` string — Descripción del detalle
      - `unidadVenta` string, required — Unidad de venta del detalle
      - `cantidad` number, double — Cantidad del producto o servicio
      - `precioUnitarioBruto` number, double — Precio unitario bruto
      - `porcentajeDescuento` number, double — Porcentaje de descuento aplicado
      - `concepto` string — Código del concepto asociado al detalle
      - `lineaImpuesto` string — Código de línea de impuesto
      - `division` string — División asociada al detalle
      - `cuenta` string — **Cuenta contable del detalle.** Este valor puede ser consultado en el endpoint → [/consultarCuentaContable](https://developer.loggro.com/reference/consultarCuentaContable#/)
      - `centroResponsabilidadCuenta` string — **Centro de responsabilidad de la cuenta detalle.** Este valor puede ser consultado en el endpoint → [/consultarCentroResponsabilidad](https://developer.loggro.com/reference/consultarCentroResponsabilidad#/)
      - `conceptoCuenta` string — **Concepto asociado a la cuenta detalle.** Este valor puede ser consultado en el endpoint → [/consultarConceptoContable](https://developer.loggro.com/reference/consultarConceptoContable#/)
      - `terceroCuenta` string — Tercero asociado a la cuenta detalle
      - `documentoCuenta` string — Documento asociado a la cuenta detalle
      - `fechaVencimiento` string — Fecha de vencimiento en formato dd/MM/yyyy
      - `diasDiferido` string — Número de días diferidos
      - `fechaDiferido` string — Fecha diferido en formato dd/MM/yyyy
      - `proyecto` string — Proyecto asociado al detalle
      - `baseDescuentoProntoPago` 'S' | 'N' — Indica si aplica descuento por pronto pago. Valores permitidos: S=Sí, N=No
      - `localizacion` string — Localización asociada al detalle
      - `conceptoIVA` string — Concepto de IVA del detalle
      - `conceptoICA` string — Concepto de ICA del detalle
      - `conceptoTIMBRE` string — Concepto de TIMBRE del detalle
      - `conceptoRIE` string — Concepto de RIE del detalle
    - `cargosDocumento` RecepcionCargosDocumentoCXPDatosEntrada[] — Lista de cargos asociados al documento.
      - `codigoCargo` string, required — Código del cargo asociado al documento.
      - `valor` number, double — Valor del cargo aplicado al documento.
      - `tipoDistribucion` 'S' | 'N' — ¿El cargo está distribuido?.
      - `lineaImpuesto` string — Código de la línea de impuesto asociada al cargo.
      - `conceptoICA` string — Código del concepto ICA aplicado al cargo.
      - `conceptoRIE` string — Código del concepto RIE aplicado al cargo.

## Response `201`

Todos los terceros fueron creados correctamente

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

## Other responses

- `400` — Error en la validación o al menos un tercero 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)