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

# Crear Documento CXP

`POST /documento_cxp`

## Request

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

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.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)