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
Back to top