Crear emisión masiva

POST/api/v1/facturas/masivas

Registra de 1 a 1000 facturas para una única recepción masiva SIAT. Requiere X-API-Key con facturas.crear e Idempotency-Key.

Header requerido X-API-KeyVer operaciones de Emisión por lote y masiva

Contrato de la operación

Registra de 1 a 1000 facturas para una única recepción masiva SIAT. Requiere X-API-Key con facturas.crear e Idempotency-Key.

Todas las facturas comparten puntoVentaId, codigoDocumentoSector y el tipo fiscal derivado del sector. Primero se validan; un worker reserva correlativos consecutivos, genera CUF con código de emisión 3, firma y empaqueta los XML, y envía una sola recepción. Responde 202, 400, 401, 403, 409, 425 o 429.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "puntoVentaId": "{{puntoVentaId}}",
  "codigoDocumentoSector": 1,
  "facturas": [
    {
      "cliente": {
        "codigoTipoDocumento": 5,
        "numeroDocumento": "99001",
        "razonSocial": "CLIENTE DE DEMOSTRACIÓN",
        "codigoCliente": "CLIENTE-99001"
      },
      "pago": {
        "codigoMetodoPago": 1
      },
      "datosSector": {
        "codigoMoneda": 1,
        "tipoCambio": 1
      },
      "detalles": [
        {
          "actividadEconomica": "{{actividadEconomica}}",
          "codigoProductoSin": 1003914,
          "descripcion": "Servicio",
          "cantidad": 1,
          "codigoUnidadMedida": 58,
          "precioUnitario": 100,
          "datosSector": {}
        }
      ]
    }
  ]
}

Reemplaza el valor por un UUID v4. Conserva la misma clave al reintentar; usa una nueva para otra operación.

Respuesta

Ejemplo de respuesta

202 Acceptedapplication/json

JSON

{
  "message": "emisión masiva registrada",
  "data": {
    "emisionMasivaId": "00000000-0000-4000-8000-000000000001",
    "estado": "pendiente",
    "ambiente": "pruebas",
    "puntoVentaId": "00000000-0000-4000-8000-000000000002",
    "codigoDocumentoSector": 1,
    "tipoFacturaDocumento": 1,
    "cantidadFacturas": 1,
    "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 Emisión por lote y masiva