Llegó un CFE de otro emisor

POST

Se registró un comprobante recibido por intercambio electrónico. Con cfeRecibidoId traés el detalle, el PDF y el XML firmado desde GET /v1/cfe/recibidos/{id} (alcance recibidos:leer).

Lo entrega Host Factura a la url de tu suscripción, no es una ruta de esta API. Respondé 2xx en menos de 10 segundos; cualquier otra cosa dispara el backoff (5 s, 30 s, 5 min, 30 min, 2 h, 12 h y después DEAD).

Cuerpo de la solicitud ^required

Envelope del evento, firmado con HMAC-SHA256

Entrega del evento cfe_recibido.creado.

object

id

required

UUID v7 del evento. ESTABLE entre reintentos: es la clave de deduplicación del receptor

string format: uuid

tipo

required

Tipo del evento, p. ej. pago.confirmado

string

creadoEn

required

ISO 8601 con offset America/Montevideo

string

cuentaId

required

Cuenta que originó el evento

string format: uuid

sucursalId

required

Sucursal del evento, o null si es de la cuenta entera

string format: uuid

nullable

datos

required

object

cfeRecibidoId

required

string format: uuid

tipo

required

integer

serie

required

string

numero

required

integer

rutEmisor

required

string

moneda

required

string

total

required

number

pendienteAceptacion

required

boolean

aceptadoComercial

required

boolean

nullable

estadoDgi

required

string

nullable

anulado

required

boolean

tipoActualizacion

Sólo en cfe_recibido.actualizado

string

Allowed values: comercial dgi

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "cfe_recibido.creado",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "cfeRecibidoId": "2b7c1d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
    "tipo": 111,
    "serie": "A",
    "numero": 5000,
    "rutEmisor": "212345670019",
    "moneda": "UYU",
    "total": 1220,
    "pendienteAceptacion": true,
    "aceptadoComercial": null,
    "estadoDgi": "A",
    "anulado": false
  }
}

Respuestas

200

Recibido. Cualquier 2xx cierra la entrega; el cuerpo de la respuesta se ignora.

410

Endpoint retirado. Host Factura NO desuscribe automáticamente: la entrega se reintenta igual y después queda DEAD. Para dejar de recibir, borrá la suscripción con DELETE /v1/webhooks/{id}.