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.