Referencia

OpenAPI 3.0

Puede consultar la referencia swagger/open-api3.0 desde el siguiente enlace.

Métodos De Notificación

Cuando el servicio identifica una nueva solicitud de cancelación, ofrece la posibilidad de notificar al receptor mediante:

• Petición HTTP (Webhook)
• Email

Webhook

Una solicitud HTTP es enviada al recurso indicado al registrar al receptor en el sistema:

{
    "folio": "4d4cef89-7bd0-436b-b288-c75ce3eb3ff0",
    "estatus": "SOLICITADA",
    "fechaEmision": "2023-12-03T10:15:30",
    "fechaCertificacion": "2023-12-03T10:15:35",
    "fechaEstatus": "2023-12-29T11:00:30", // (1)
    "fechaSolicitud": "2023-12-29T11:00:30",
    "pac": "BBB010101BBB",
    "rfcEmisor": "AAA010101AAA",
    "razonSocialEmisor": "ACME SA DE CV",
    "receptor": {
        "rfc": "CCC010101CCC",
        "razonSocial": "FOO BAR SA DE CV",
    }
}

1. Indica la fecha en la que la solicitud cambio de estatus.

Para los POST de Webhook, el servicio escucha los siguientes códigos de tu servidor y reacciona en consecuencia:

• Si el servicio recibe un código 200 (Éxito) determinará que el POST del webhook es exitoso y no reintentará.
• Si servicio recibe un código 406 (No aceptable), servicio determinará que el POST es rechazado y no reintentará.
• Para cualquier otro código , el servicio reintentará POST según la siguiente política: 3 intentos y 5 segundos entre cada intento exponencialmente ^2.

Firma Webhook

Con el objetivo de garantizar la integridad y no repudio de los eventos HTTP (webhooks) que se disparan al momento de registrar solicitudes de cancelación, las peticiones HTTP resultantes contienen una firma criptográfica en el header X-Signature la cual puede ser verificada con la siguiente llave:

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCNab/19cpLRvGok1WJYioKDE74
ItwPcR0xe54wLjAlsrr2OvXYqyXOoHmt/fFkdDN6n5LJ1gaL8Yxcn45j2gJfpUZ6
M+pviTYs3benQVZjle8Gg0i0VRSlE7GXVby2nW7RosHRtyt2xbb8umEgRYIUT9UD
86nGLkWS5QBwmBm5mwIDAQAB
-----END PUBLIC KEY-----

Especificaciones de la firma:

Email