Tenancy
Distribuidores
Implementación de API para Cancelación-Distribuidores de Comprobantes Digitales por Internet.
Descargar Documento
La dirección donde se encuentra publicada la API para pruebas
es la siguiente: URL :
https://apitest.paxfacturacion.com.mx/cancelacion/cfdi/distribuidor
Producción link La dirección donde se encuentra publicada la API para producción
es la siguiente: URL :
https://api.paxfacturacion.com.mx/cancelacion/cfdi/distribuidor
Petición link La estructura de la petición para enviar la cancelación es la siguiente:
Cuerpo de petición link
Formato XML se enviará en el Body de la petición.
<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">
<CancelaCFD
xmlns="http://cancelacfd.sat.gob.mx">
<Cancelacion RfcEmisor="CFA110411FW5" Fecha="2024-04-24T12:57:14" >
<Folios>
<Folio UUID="713C6FFC-3787-8346-83D4-D93B0A27D1A7" Motivo="02" />
</Folios>
<Signature>
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<DigestValue>w9xxrdckxxGBYqhZPC7kOlwlRwo=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>HS5PmcSGfzeWIH1gX4S+C1CNOyhobjOtrny7JP1JX3GA0fDqIfCB6ZuWcbRDK86/Qr111futA7elHJ1PYPTrJgxeUGbCwHdc8nKD+r1ObenOQJ0L+c0ApdFL08RA+9FS7oSgXVSQLE4fLT2qYrQv3JFNELE1EV4c862k8lVXOR+d+HXi+ABVnOSYWXnMn7A9UUHAhn6KCycMT8S02Fz6ZTr/CDJUff0ed+vqu1pQtDirREDNeVsmtooRj2h1ocsFiwc50Xlf8AKXPvDfPS17eA0ueFLGdASU1eKkkvOGaanjA1T3D7S0X04CZEFj8MpwcBL8BhqRSbmzA1KevJ7sDw==</SignatureValue>
<KeyInfo>
<X509Data>
<X509IssuerSerial>
<X509IssuerName>OID.1.2.840.113549.1.9.2=responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE, OID.2.5.4.45=SAT970701NN3, L=CUAUHTEMOC, S=CIUDAD DE MEXICO, C=MX, PostalCode=06300, STREET="AV. HIDALGO 77, COL. GUERRERO", E=contacto.tecnico@sat.gob.mx, OU=SAT-IES Authority, O=SERVICIO DE ADMINISTRACION TRIBUTARIA, CN=AUTORIDAD CERTIFICADORA</X509IssuerName>
<X509SerialNumber>275106190557734483187066766829381011764153825591</X509SerialNumber>
</X509IssuerSerial>
<X509Certificate>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</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</Cancelacion>
</CancelaCFD>
</s:Body>
</s:Envelope>
Cabeceras de petición link
Key
Value
Connection
Keep-alive
Content-Type
application/xml
Authorization
Bearer
Content-Length
443
RevisarEstatus
true
RFCReceptor
XAXX010101000
Total
1.00
Host
apitest.paxfacturacion.com.mx
Agent
Apache-HttpClient/4.5.3 (Java/1.8.0_401)
[no cookies]
Enviar Header Authorization con este tipo de contenido Bearer Token .
Formato JSON se enviará en el Body de la petición.
{
"Body": {
"CancelaCFD": {
"Cancelacion": {
"RfcEmisor": "CFA110411FW5",
"Fecha": "2024-04-24T12:57:14",
"Folios": {
"Folio": {
"UUID": "713C6FFC-3787-8346-83D4-D93B0A27D1A7",
"Motivo": "02"
}
},
"Signature": {
"SignedInfo": {
"CanonicalizationMethod": {
"@Algorithm": "http://www.w3.org/TR/2001/REC-xml-c14n-20010315"
},
"SignatureMethod": {
"@Algorithm": "http://www.w3.org/2000/09/xmldsig#rsa-sha1"
},
"Reference": {
"@URI": "",
"Transforms": {
"Transform": {
"@Algorithm": "http://www.w3.org/2000/09/xmldsig#enveloped-signature"
}
},
"DigestMethod": {
"@Algorithm": "http://www.w3.org/2000/09/xmldsig#sha1"
},
"DigestValue": "w9xxrdckxxGBYqhZPC7kOlwlRwo="
}
},
"SignatureValue": "HS5PmcSGfzeWIH1gX4S+C1CNOyhobjOtrny7JP1JX3GA0fDqIfCB6ZuWcbRDK86/Qr111futA7elHJ1PYPTrJgxeUGbCwHdc8nKD+r1ObenOQJ0L+c0ApdFL08RA+9FS7oSgXVSQLE4fLT2qYrQv3JFNELE1EV4c862k8lVXOR+d+HXi+ABVnOSYWXnMn7A9UUHAhn6KCycMT8S02Fz6ZTr/CDJUff0ed+vqu1pQtDirREDNeVsmtooRj2h1ocsFiwc50Xlf8AKXPvDfPS17eA0ueFLGdASU1eKkkvOGaanjA1T3D7S0X04CZEFj8MpwcBL8BhqRSbmzA1KevJ7sDw==",
"KeyInfo": {
"X509Data": {
"X509IssuerSerial": {
"X509IssuerName": "OID.1.2.840.113549.1.9.2=responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE, OID.2.5.4.45=SAT970701NN3, L=CUAUHTEMOC, S=CIUDAD DE MEXICO, C=MX, PostalCode=06300, STREET=\"AV. HIDALGO 77, COL. GUERRERO\", E=contacto.tecnico@sat.gob.mx, OU=SAT-IES Authority, O=SERVICIO DE ADMINISTRACION TRIBUTARIA, CN=AUTORIDAD CERTIFICADORA",
"X509SerialNumber": "275106190557734483187066766829381011764153825591"
},
"X509Certificate": "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"
}
}
}
}
}
}
}
Cabeceras de petición link
Key
Value
Connection
Keep-alive
Content-Type
application/json
Authorization
Bearer
Content-Length
246
RevisarEstatus
false
RFCReceptor
XAXX010101000
Total
1.00
Host
apitest.paxfacturacion.com.mx
Agent
Apache-HttpClient/4.5.3 (Java/1.8.0_401)
[no cookies]
Asegúrate de enviar los siguientes encabezados en tu solicitud:
Header Content-Type : Debe tener el valor application/json .
Header Authorization : Debe tener el valor Bearer Token .
El siguiente token
es el que debes ingresar como valor en la llave Authorization
.
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IndzZGxfcGF4Iiwicm9sZSI6IlVzdWFyaW8iLCJuYmYiOjE3MDk2NTg1NDIsImV4cCI6MTcwOTY4MDE0MiwiaWF0IjoxNzA5NjU4NTQyLCJpc3MiOiJodHRwczovL3Rlc3QucGF4ZmFjdHVyYWNpb24uY29tLm14OjQ5MCIsImF1ZCI6Imh0dHBzOi8vdGVzdC5wYXhmYWN0dXJhY2lvbi5jb20ubXg6NDkwIn0.aDK-95uWY8rzBJE9zhS_CwEj0iAz64wpG83JyZ6z2C8
Se tienen que crear los siguientes HEADERS
en la petición:
Atributo
Descripción
RevisarEstatus
Atributo requerido para especificar si se revisa el estatus del CFDI antes de enviar la cancelación. Valores: False
(no revisar el estatus), True
(revisar el estatus).
RFCReceptor
Atributo opcional del RFC del receptor del CFDI a cancelar. Es requerido si se desea revisar el estatus de cancelación antes de proceder con la cancelación.
Total
Atributo opcional con el total del CFDI a cancelar. Es necesario si se desea revisar el estatus de cancelación antes de enviar la solicitud.
info
Nota : los siguientes parametros se envian en la firma de la peticion:
Atributo
Descripción
MotivoCancelacion
Atributo requerido para especificar el motivo de la cancelación del CFDI. 01
: Comprobantes con errores relacionados.02
: Comprobantes con errores sin relación.03
: No se realizó la operación.04
: Operación nominativa relacionada con una factura global.
FolioSustitucion
Atributo opcional para especificar el UUID con el que se va a sustituir la cancelación. Es requerido cuando el motivo de cancelación es 01
(errores con relación).
Respuesta link
<Cancelacion
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" RfcEmisor="XAXX010101000" Fecha="2024-03-05T11:45:05"
xmlns="http://cancelacfd.sat.gob.mx">
<Folios>
<UUID>95c2083f-1868-41d6-b076-f39c608435d7 </UUID>
<UUIDEstatus>201 </UUIDEstatus>
<UUIDdescripcion>201 - UUID cancelado sin aceptación </UUIDdescripcion>
<UUIDfecha>2013-01-01T18:08:10 </UUIDfecha>
</Folios>
<Signature>
PRUEBAs3Vh7XjOpPasAskqXdrrRSazgqZcq0VoT9jLNmvibxuGWZ4wp2QKFrFANbku63Tg//DZFH7x6BJ4B6kv268gWg==
</Signature>
</Cancelacion>
{
"Cancelacion": {
"@xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
"@xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"@RfcEmisor": "XAXX010101000",
"@Fecha": "2024-03-05T11:51:37",
"@xmlns": "http://cancelacfd.sat.gob.mx",
"Folios": {
"UUID": "95c2083f-1868-41d6-b076-f39c608435d7 ",
"UUIDEstatus": "201 ",
"UUIDdescripcion": "201 - UUID cancelado sin aceptación ",
"UUIDfecha": "2013-01-01T18:08:10 "
},
"Signature": "PRUEBAs3Vh7XjOpPasAskqXdrrRSazgqZcq0VoT9jLNmvibxuGWZ4wp2QKFrFANbku63Tg//DZFH7x6BJ4B6kv268gWg=="
}
}
Credenciales link El usuario y contraseña para pruebas son los siguientes:
Usuario:
Contraseña:
wqfCr8O3xLfEhMOHw4nEjMSrxJnvv7bvvr4cVcKuKkBEM++/ke+/gCPvv4nvvrfvvaDvvb/vvqTvvoA=
Códigos de error link A la hora de utilizar nuestro servicio es posible que te encuentres con ciertos errores. La siguiente lista tiene como objetivo ayudarte a comprender qué significa cada código de error y a solucionar problemas de manera más eficiente.
Código
Descripción
301
XML mal formado.
302
Sello mal formado o inválido.
303
Sello no corresponde a emisor o caduco.
304
Certificado revocado o caduco.
305
La fecha de emisión no está dentro de la vigencia del CSD del Emisor.
306
El certificado no es de tipo CSD.
307
El CFDI contiene un timbre previo.
308
Certificado no expedido por el SAT.
310
CSD inválido.
311
Clave de motivo de cancelación no válida.
312
UUID no relacionado de acuerdo con la clave de motivo de cancelación.
101
El CFDI no se puede cancelar porque contiene relacionado el complemento de pagos.
102
El CFDI no se puede cancelar porque contiene comprobantes relacionados vigentes, para cancelarlo deberá cancelar previamente todos los comprobantes relacionados.
103
El CFDI ha sido Cancelado Previamente por Aceptación del Receptor.
104
El CFDI no se puede Cancelar por que fue Rechazado Previamente.
105
El CFDI no se puede Cancelar porque tiene estatus de ‘En espera de Aceptación’.
106
El CFDI no se puede Cancelar porque tiene estatus de ‘En Proceso’.
107
El CFDI ha sido Cancelado Previamente por Plazo Vencido.
108
El CFDI ha sido cancelado previamente por plazo vencido, no puede ser aceptado.
109
El CFDI ha sido cancelado previamente, no puede ser aceptado.
110
El CFDI ha sido cancelado previamente. por plazo vencido, no puede ser rechazado.
111
El CFDI ha sido cancelado previamente, no puede ser rechazado.
95
Usuario o contraseña incorrecta.
97
No hay créditos disponibles.
201
UUID cancelado sin aceptación.
202
UUID Previamente Cancelado.
203
UUID No corresponde al emisor.
204
UUID No aplicable para Cancelación, intente en 10 minutos.
205
UUID No existente, intente en 10 minutos.
206
UUID no corresponde a un CFDI del Sector Primario.
207
Folio sustitución Inválido.
208
La Fecha de Solicitud de Cancelación es mayor a la fecha de declaración.
209
La Fecha de Solicitud de Cancelación límite para factura global.
997
Revisar los parámetros de la petición.
990
Tipo de Contenido no soportado.
check_circle
El costo del Servicio es de 1 Créditos por petición.