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
,SOAPAction
o 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