Cambió el estado de un CFE en DGI

POST

Respuesta definitiva de DGI sobre un CFE emitido. Se emite una vez por estado alcanzado (el dedupe lleva el estado como sufijo), así que un CFE que pasa de pendiente a aceptado genera dos entregas con id distintos.

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

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

integer

serie

required

string

nullable

numero

required

integer

nullable

estadoDgi

required

string

nullable

codigoSucursalDgi

required

integer

nullable

estado

required

Estado unificado y legible, derivado del estado del sobre DGI

string

Allowed values: aceptado rechazado observado pendiente

estadoSobre

required

Estado del SOBRE en DGI (EstadoSobre). estado lo traduce; esto es el valor crudo, para quien necesite distinguir enviado (hay ACKSobre pero todavia no ACKCFE).

string

Allowed values: enviado aceptado rechazado observado

motivoDgi

required

string

nullable

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "cfe.actualizado",
  "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,
    "estado": "aceptado",
    "estadoSobre": "aceptado",
    "motivoDgi": null
  }
}

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