Pendientes de Cancelación
Producto: PAC Services – Tralix
1 Introducción
El servicio de Pendientes de Cancelación permite a los receptores de facturas electrónicas consultar si existen comprobantes fiscales digitales por Internet (CFDIs) emitidos a su nombre que han sido solicitados para cancelación por parte del emisor y están pendientes de aceptación o rechazo.
Este servicio opera mediante una llamada SOAP con método POST. Está diseñado para clientes que desean dar seguimiento a las cancelaciones que deben ser respondidas activamente.
Nota: Cada consulta de cancelación consume un timbre del paquete contratado.
2 Estructura del Servicio
2.1 Estructura general de la petición
La solicitud se realiza con una estructura SOAP simple que incluye el RFC del receptor como parámetro dentro del nodo ObtenerPeticionesPendientes.
2.2 Parámetros requeridos
Endpoint
| Método | Entorno | URL |
|---|---|---|
| POST | Pruebas | 🔗 https://pruebastfd.tralix.com:8081/cancela/pendientesSoap/ |
| POST | Productivo | 🔗 https://timbrador.tralix.com:8081/cancela/pendientesSoap/ |
Autenticación y Headers
| Header | Valor esperado |
|---|---|
SOAPAction |
"http://cancelacfd.sat.gob.mx/IAceptacionRechazoService/ObtenerPeticionesPendientes" |
Content-Type |
text/xml; charset=utf-8 |
CustomerKey |
{CUSTOMER_KEY} (clave única asignada al cliente) |
Parámetros
| Campo | Tipo | Descripción |
|---|---|---|
rfcReceptor |
Texto | RFC del receptor que desea consultar las solicitudes pendientes de cancelación. |
2.3 Ejemplo de petición
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:can="http://cancelacfd.sat.gob.mx">
<soapenv:Body>
<can:ObtenerPeticionesPendientes>
<can:rfcReceptor>[RFC_RECEPTOR]</can:rfcReceptor>
</can:ObtenerPeticionesPendientes>
</soapenv:Body>
</soapenv:Envelope>
2.4 Ejemplo de respuesta
Caso exitoso con resultados:
<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<ObtenerPeticionesPendientesResponse xmlns="http://cancelacfd.sat.gob.mx">
<ObtenerPeticionesPendientesResult CodEstatus="1100">
<UUID>[UUID_EN_ESPERA]</UUID>
</ObtenerPeticionesPendientesResult>
</ObtenerPeticionesPendientesResponse>
</s:Body>
</s:Envelope>
2.5 Códigos de respuesta
| Código | Descripción | Observaciones |
|---|---|---|
| 300 | Usuario No Válido | Este código de error se regresa cuando la autenticación del usuario no fue exitosa. |
| 301 | XML Mail Formato | Este código de error se regresa cuando el request posee información invalida, ejemplo: un RFC de receptor no válido. |
| 1100 | Se recibió la respuesta de la petición de forma exitosa | |
| 1001 | No existen peticiones para el RFC Receptor | Este código se regresa cuando la consulta se realizó de manera exitosa, pero no se encontraron solicitudes de cancelación para el rfc receptor |
3 Consideraciones Técnicas
-
El RFC del receptor debe ser válido y estar registrado en la plataforma Tralix.
-
El CustomerKey debe ser vigente y tener permisos para consultar este servicio.
-
La autenticación es estricta: un error en
CustomerKey,SOAPActiono estructura XML generará una respuesta con error.
4 Contacto y Soporte
- Para soporte técnico o dudas sobre el uso del servicio, puede comunicarse con el área de soporte técnico de Tralix vía ticket.
No Comments