Flujo de Cancelación

Producto: PAC Services – Tralix

1 Introducción

El presente manual tiene como propósito proporcionar una guía técnica detallada sobre el Flujo de Cancelación de CFDI a través del producto PAC Services – Tralix. Esta funcionalidad permite a emisores y receptores de comprobantes fiscales digitales realizar y gestionar cancelaciones conforme a los lineamientos establecidos por el Servicio de Administración Tributaria (SAT).

El flujo de cancelación está compuesto por distintos servicios que permiten ejecutar la cancelación de un CFDI, consultar su estatus fiscal, conocer los comprobantes pendientes por cancelación y aceptar o rechazar solicitudes cuando sea necesario. Todos estos servicios se ofrecen a través de interfaces REST que pueden consumir tanto contenido XML como JSON, dependiendo del tipo de operación.

Este documento está dirigido a desarrolladores, integradores y personal técnico responsable de la implementación del servicio en los sistemas del cliente. Cada sección describe el uso adecuado de los endpoints, la estructura de las peticiones y respuestas, los parámetros necesarios, ejemplos prácticos, así como las validaciones y consideraciones técnicas que se deben cumplir para garantizar una integración exitosa.

Además, se incluye información clave sobre autenticación, headers, formatos permitidos, cardinalidad, firma digital y tratamiento de errores, con el fin de facilitar la comprensión y uso correcto de cada componente del flujo.

Nota: Toda consulta de cancelación realizada a través de este servicio consume un timbre del paquete contratado por el cliente.

2 Servicio de Cancelación

El servicio Cancelación permite a los emisores de CFDI realizar la cancelación de uno o varios comprobantes en una sola petición. Esta operación se realiza mediante un servicio REST con contenido en XML y requiere que el XML esté firmado digitalmente con el CSD del emisor.

La cancelación debe cumplir con los lineamientos establecidos por el SAT, incluyendo la especificación del motivo de cancelación y, en su caso, el UUID del CFDI sustituto.

2.1 Estructura general de la petición

El servicio acepta contenido XML con una estructura específica que contiene los datos de cancelación por cada UUID. Se permite cancelar de 1 a 500 comprobantes en una sola petición (cardinalidad 1:500).

2.2 Parámetros requeridos

Endpoint

Esta operación se realiza mediante un servicio REST.

Autenticación y Headers

Parámetros 

2.3 Ejemplo de petición

<CancelaCFD xmlns="http://cancelacfd.sat.gob.mx">
<Cancelacion Fecha="[Fecha]" RfcEmisor="[RFC_EMISOR]" 
             xmlns="http://cancelacfd.sat.gob.mx" 
             xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Folios>
    <Folio UUID="[UUID]" Motivo="01" FolioSustitucion="[UUID]"/>
    <RfcReceptor>[RFC_RECEPTOR]</RfcReceptor>
    <Total>[TOTAL_FACTURA]</Total>
  </Folios>
  <Folios>
    <Folio UUID="[UUID]" Motivo="02" />
    <RfcReceptor>[RFC_RECEPTOR]</RfcReceptor>
    <Total>[TOTAL_FACTURA]</Total>
  </Folios>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" />
  </Cancelacion>
</CancelaCFD>

2.4 Ejemplo de respuesta

<CancellationResponses>
    <CancellationResponse uuid="[UUID]" estado="[ESTADO_CFDI]">
        <CancelaCFDResponse 
                            xmlns="http://cancelacfd.sat.gob.mx" 
                            xmlns:cfdi="http://www.sat.gob.mx/cfd/3" 
                            xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" />
    </CancellationResponse>
    <CancellationResponse uuid="[UUID]" estado="[ESTADO_CFDI]">
        <Error />
    </CancellationResponse>
</CancellationResponses>

2.5 Códigos de respuesta

El atributo estado dentro del nodo <CancellationResponse> indicará el resultado para cada UUID:

2.6. Consideraciones Técnicas

• Se permite cancelar hasta 500 CFDIs por solicitud.

• El XML debe ser firmado con el CSD vigente del emisor.

3. Consulta de Estados de CFDI

El servicio Consulta de Estados permite realizar una búsqueda del estatus fiscal de uno o varios Comprobantes Fiscales Digitales por Internet (CFDIs) entregados al SAT. Este servicio responde con información sobre si el comprobante se encuentra vigente, cancelado o en proceso de cancelación, así como si es cancelable.

Este servicio está disponible en dos formatos, :

3.1 Estructura general de la petición

La petición puede realizarse de dos formas, dependiendo del tipo de consumo:

3.2 Parámetros requeridos

Endpoint

Esta operación se realiza mediante un servicio REST.

Autenticación y Headers

Parámetros

Para consulta individual (XML):

Para consulta masiva (JSON):

3.3 Ejemplo de petición

XML (1:1):

<tem:Consulta xmlns:tem="http://tempuri.org/"> 
    <tem:expresionImpresa>
      <![CDATA[?re=[RFC_EMISOR]]&rr=[RFC_RECEPTOR]&tt=[TOTAL]&id=[UUID]]]>
  </tem:expresionImpresa>
</tem:Consulta>

JSON (1:500):

{
    "statusVerifierList": [
        {
            "rfcEmisor": "[RFC_EMISOR]",
            "rfcReceptor": "[RFC_RECEPTOR]",
            "total": "[TOTAL]",
            "uuid": "[UUID]"
        },{
            "rfcEmisor": "[RFC_EMISOR]",
            "rfcReceptor": "[RFC_RECEPTOR]",
            "total": "[TOTAL]",
            "uuid": "[UUID]"
        }
    ]
}

3.4 Ejemplo de respuesta

XML (respuesta individual):

<ConsultaResponse xmlns="http://tempuri.org/" xmlns:cfdi="http://www.sat.gob.mx/cfd/3" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <ConsultaResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:a="http://schemas.datacontract.org/2004/07/Sat.Cfdi.Negocio.ConsultaCfdi.Servicio">
        <a:CodigoEstatus>S - Comprobante obtenido satisfactoriamente.</a:CodigoEstatus>
        <a:EsCancelable>Cancelable con aceptación</a:EsCancelable>
        <a:Estado>Cancelado</a:Estado>
        <a:EstatusCancelacion>Cancelado con aceptación</a:EstatusCancelacion>
    </ConsultaResult>
</ConsultaResponse>

JSON (respuesta masiva):

{
    "statusVerifierList": [
        {
            "estado": "Vigente",
            "uuid": "[UUID]",
            "codigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
            "esCancelable": "Cancelable con aceptación",
            "estatusCancelacion": ""
        },
        {
            "estado": "Vigente",
            "uuid": "[UUID]",
            "codigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
            "esCancelable": "Cancelable con aceptación",
            "estatusCancelacion": ""
        }
    ]
}

3.5 Códigos de respuesta (debe ser interpretado desde el campo codigoEstatus)

3.6 Consideraciones Técnicas

• Los montos (total) deben tener exactamente dos decimales y coincidir con el total del CFDI.

• Para consultas masivas, no se puede exceder la cardinalidad de 500 registros por solicitud.

4 Consulta Pendientes por Cancelar

El servicio Pendientes por Cancelar permite a los receptores de CFDI consultar los comprobantes fiscales que se encuentran en proceso de cancelación, es decir, aquellos que requieren aceptación o rechazo por parte del receptor para completar su cancelación.

Este servicio está disponible en dos formatos de consumo:

• Consulta individual (XML)

• Consulta individual (JSON)

Esta operación se realiza mediante un servicio REST.

Nota: La información obtenida representa solicitudes de cancelación pendientes, no implica que el CFDI esté cancelado.

4.1 Estructura general de la petición

4.2 Parámetros requeridos

Endpoint

Esta operación se realiza mediante un servicio REST.

Autenticación y Headers

Parámetros

4.3 Ejemplo de petición

XML

<can:ObtenerPeticionesPendientes xmlns:can="http://cancelacfd.sat.gob.mx">
  <can:rfcReceptor>[RFC_RECEPTOR]</can:rfcReceptor>
</can:ObtenerPeticionesPendientes>

JSON

{
  "rfcReceptor": "CALJ581101M37"
}

4.4 Ejemplo de respuesta

XML

<ObtenerPeticionesPendientesResponse xmlns="http://cancelacfd.sat.gob.mx"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<ObtenerPeticionesPendientesResult CodEstatus="1100">
  <UUID>[UUID]</UUID>
  <UUID>[UUID]</UUID>
  </ObtenerPeticionesPendientesResult>
</ObtenerPeticionesPendientesResponse>

JSON

{
  "codStatus": "1100",
  "uuids": [
    {
      "uuid": "[UUID]"
    },{
      "uuid": "[UUID]"
    }
  ]
}

4.5. Consideraciones Técnicas

• Se recomienda validar previamente que el RFC receptor sea correcto y activo.

• No se permite enviar múltiples RFCs por solicitud (cardinalidad 1:1).

• El sistema solo devolverá UUIDs con estatus "En proceso" de cancelación.

• Este servicio no genera cancelaciones ni acepta/rechaza solicitudes, solo consulta el estado actual.

5 Consulta de Aceptación o Rechazo de Cancelación CFDI

El servicio de Aceptación o Rechazo permite a los receptores de CFDI responder una solicitud de cancelación realizada por el emisor. Aplica únicamente para CFDIs que se encuentran con estatus "En Proceso", es decir, aquellos que requieren autorización del receptor para que su cancelación sea válida.

Mediante este servicio, el receptor puede confirmar si acepta o rechaza la cancelación del comprobante correspondiente. La respuesta se debe enviar firmada con el certificado del receptor.

Esta operación se realiza mediante un servicio REST.

5.1 Estructura general de la petición

5.2 Parámetros requeridos

Endpoint

Esta operación se realiza mediante un servicio REST.

Autenticación y Headers

Parámetros

5.3 Ejemplo de petición

<can:ProcesarRespuesta xmlns:can="http://cancelacfd.sat.gob.mx">
  <can:solicitud Fecha="[FECHA]" RfcPacEnviaSolicitud="[RFC_PAC_SOLICITANTE]" RfcReceptor="[RFC_RECEPTOR]">
    <can:Folios>
      <can:UUID>[UUID]</can:UUID>
      <can:Respuesta>[Rechazo/Aceptacion]</can:Respuesta>
    </can:Folios>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" />
  </can:solicitud>
</can:ProcesarRespuesta>

5.4 Ejemplo de respuesta

<ProcesarRespuestaResponse xmlns="http://cancelacfd.sat.gob.mx"
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                           xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <ProcesarRespuestaResult Fecha="[FECHA]" 
                           CodEstatus="[COD_ESTATUS]" 
                           RfcPac="[RFC_PAC]"
                           RfcReceptor="[RFC_RECEPTOR]">
    <Folios Respuesta="Rechazo">
      <UUID>[UUID]</UUID>
      <EstatusUUID>[ESTATUS_UUID]</EstatusUUID>
    </Folios>
    <Signature Id="SelloSAT" xmlns="http://www.w3.org/2000/09/xmldsig#" />
  </ProcesarRespuestaResult>
</ProcesarRespuestaResponse>

5.5 Consideraciones Técnicas

6 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.