Confirmar compras reportadas

POST/api/v1/compras/confirmar

Confirma compras que los emisores ya reportaron al NIT comprador en SIAT. Requiere X-API-Key con permiso facturas.crear. No requiere Idempotency-Key. Empresa y ambiente se obtienen de la clave; X-Tenant-ID no concede acceso. El punto de venta debe pertenecer a esa empresa y estar activo.

Header requerido X-API-KeyVer operaciones de Recepción de compras

Contrato de la operación

Confirma compras que los emisores ya reportaron al NIT comprador en SIAT. Requiere X-API-Key con permiso facturas.crear. No requiere Idempotency-Key. Empresa y ambiente se obtienen de la clave; X-Tenant-ID no concede acceso. El punto de venta debe pertenecer a esa empresa y estar activo.

Cuerpo

puntoVentaId: UUID del punto de venta de la empresa.
periodoFiscal: obligatorio, formato AAAA-MM; gestión entre 2000 y el año siguiente al actual.
tipoCompra: destino fiscal común del lote, entre 1 y 5. Se puede omitir si cada compra declara el suyo.
compras: entre 1 y 500 compras, sin duplicados de NIT emisor, autorización y número de factura dentro del lote.

Cada compra exige nitEmisor, codigoAutorizacion y numeroFactura. nitEmisor es un entero positivo de hasta 12 dígitos; la autorización admite hasta 100 caracteres. numeroFactura se envía como texto de 1 a 20 dígitos, por ejemplo "12345678901234567890", para conservar su precisión. El tipoCompra individual reemplaza el común; omitido o 0 usa el del lote. Toda compra debe tener un tipo efectivo entre 1 y 5:

Código	Destino
1	Mercado interno: actividades gravadas.
2	Mercado interno: actividades no gravadas.
3	Uso sujeto a proporcionalidad entre actividades gravadas y no gravadas.
4	Exportación.
5	Uso compartido entre mercado interno y exportación.

Los identificadores deben corresponder a compras recuperadas mediante consultaCompras del SIAT. Este endpoint recibe la selección del cliente; no rea...

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "puntoVentaId": "{{puntoVentaId}}",
  "periodoFiscal": "2026-08",
  "tipoCompra": 1,
  "compras": [
    {
      "nitEmisor": 123456789,
      "codigoAutorizacion": "ABC123456789",
      "numeroFactura": "123"
    }
  ]
}

Respuesta

Ejemplo de respuesta

201 Createdapplication/json

JSON

{
  "message": "confirmación de compras enviada correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operacion": "confirmacion",
    "codigoSucursal": 0,
    "codigoPuntoVenta": 0,
    "gestion": 2026,
    "periodo": 8,
    "cantidadFacturas": 1,
    "hashArchivo": "ec85c44e4f9d72d4c7d78c839af85e6563d43ad8ee56a231cbeaa8c5354735c8",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000010",
    "codigoEstado": 908,
    "codigoDescripcion": "VALIDADA",
    "estado": "aceptado",
    "fechaEnvio": "2026-08-30T16:10:00-04:00",
    "creadoEn": "2026-08-30T16:10:00-04:00",
    "actualizadoEn": "2026-08-30T16:10:00-04:00"
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Recepción de compras