CFE emitido

POST

Un CFE se emitió y quedó registrado. No significa que DGI lo aceptó: eso llega después en cfe.actualizado. Con incluirMetadata: true en la suscripción, este evento —y sólo este— agrega los campos personalizados en datos.metadata.

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

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

cfeId

required

string format: uuid

tipo

required

Código de tipo de CFE de DGI (101…182)

integer

serie

required

string

nullable

numero

required

integer

nullable

estadoDgi

required

string

nullable

codigoSucursalDgi

required

CdgDGISucur ante DGI. No es el sucursalId del envelope

integer

nullable

metadata

Sólo con incluirMetadata: true en la suscripción, y sólo en cfe.emitido

object

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "cfe.emitido",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "cfeId": "1f2a3b4c-5d6e-4f7a-8b9c-0d1e2f3a4b5c",
    "tipo": 101,
    "serie": "A",
    "numero": 1042,
    "estadoDgi": "AC",
    "codigoSucursalDgi": 1
  }
}

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