Obtener emisión masiva

GET/api/v1/facturas/masivas/:emisionMasivaId

Consulta el estado persistido sin volver a enviar el paquete. Requiere facturas.consultar; sólo permite acceder a emisiones de la empresa vinculada a la clave.

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

Contrato de la operación

Consulta el estado persistido sin volver a enviar el paquete. Requiere facturas.consultar; sólo permite acceder a emisiones de la empresa vinculada a la clave.

Estados de proceso: pendiente, preparando, pendiente_validacion, error_reintentable y resultado_incierto. Estados terminales: validado, observado, rechazado, contingente o fallido. Los códigos SIAT habituales son 901 pendiente, 902 rechazada, 903 procesada, 904 observada y 908 validada. Responde 200, 401, 403 o 404.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · GET

export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export EMISION_MASIVA_ID='REEMPLAZA_CON_EMISION_MASIVA_ID'

curl --request GET \
  --url "$FALMUS_API_URL/facturas/masivas/${EMISION_MASIVA_ID}" \
  --header "X-API-Key: $FALMUS_API_KEY"

Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "emisión masiva obtenida",
  "data": {
    "emisionMasivaId": "00000000-0000-4000-8000-000000000001",
    "estado": "pendiente_validacion",
    "ambiente": "pruebas",
    "puntoVentaId": "00000000-0000-4000-8000-000000000002",
    "codigoDocumentoSector": 1,
    "tipoFacturaDocumento": 1,
    "cantidadFacturas": 1000,
    "codigoRecepcion": "ABC123",
    "codigoEstado": 901,
    "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