Consultas relacionadas a cancelaciones de CFDI
Este servicio permite consultar ante el SAT información de CFDI.
Contenido
-
Características generales
- Consulta estado del CFDI en el SAT
- Consulta de folios fiscales pendientes de respuesta de cancelación (Receptor)
- Consulta de CFDI Relacionados (Receptor)
- Requisitos para consulta de información de un CFDI
-
Método [
ConsultaCFDIService
]- Solicitud ConsultaEstadoCFDI
- Respuesta ConsultaEstadoCFDI
- Códigos de Respuesta del SAT para el Servicio de Consulta Estado de un CFDI
-
Método [
ConsultaPeticionesPendientes
]- Solicitud PeticionesPendientes
- Respuesta PeticionesPendientes
- Códigos de Respuesta del SAT para el Servicio de Consulta de CFDI Pendientes de respuesta de cancelación
-
Método [
ConsultaUUIDRelacionados
]- Solicitud ConsultaCFDIRelacionados
- Respuesta ConsultaCFDIRelacionados
-
Método [
ConsultaUUIDRelacionadosFirmada
]: Consulta con firma de origen- Solicitud Firma de origen
- Respuesta firma de origen
- Códigos de Respuesta del SAT para el Servicio de Consulta de CFDI Relacionados
- Códigos de Error propios de la plataforma Reachcore
-
Método [
LotesCancelacion
]: Consulta de Id de Lote de Cancelación- Solicitud de Consulta de Identificador de Lote de Cancelacion
- Respuesta de Consulta de Identificador de Lote de Cancelacion
Características generales
En el esquema de consulta de información de Comprobantes Fiscales Digitales por Internet (CFDI), el SAT responde a la consulta con información resguarda en su base de datos centralizada para el padrón completo de contribuyentes. Por lo tanto, debido a este modelo centralizado, la consulta de información de un CFDI consiste en solicitar directamente al SAT la información del Comprobante. Salvo la consulta de estado de un CFDI, los métodos de consulta están enfocados hacia los Receptores de un CFDI y es necesario firmar la solicitud web hacia el SAT por medio del Certificado de Sello Digital (CSD) que pertenece al Receptor. Las consultas se hacen en línea por medio de peticiones a servicios web y los tiempos de respuesta dependen de los sistemas del SAT.
El servicio para Consulta estado del CFDI en el SAT responde con la siguiente información:
El servicio para Consulta de folios fiscales pendientes de respuesta de cancelación está enfocado hacia el Receptor de un Comprobante y se enfoca en mostrar la lista de Folios Fiscales (UUID) que un Emisor ha solicitado cancelar y que requieren de una respuesta por parte del Receptor para aceptar o rechazar la cancelación.
El servicio para Consulta de CFDI Relacionados está enfocado hacia el Receptor de un Comprobante, para que pueda conocer las relaciones que tiene un Folio Fiscal con otros Comprobantes registrados en el SAT.
Requisitos para consulta de información de un CFDI
Para hacer uso del web service de Consultas relacionadas a cancelaciones de CFDI se necesita:
- Contar con un contrato de servicios con Reachcore. En caso de no tener uno, por favor envía un correo a sales-mexico@sovos.com
- Haber generado un API Key en tu cuenta Reachcore, ya que es el un identificador que te autentica en los Web Services de la plataforma. Para consultar como generar el API Key, consulta este artículo: Generar API Key para Web Services.
Para las consultas que requieren del Certificado de Sello Digital (CSD) para la firma de petición de consulta en el SAT, se debe contar con un CSD vigente y cargado en la plataforma de Reachcore.
El CSD generalmente consta de tres partes:
- El Certificado, que es un archivo con extensión .cer
- La llave privada, que es un archivo con extensión .key
- y la contraseña de la llave privada.
Para obtener un certificado de sello digital (CSD) del SAT, consultar los requisitos y el procedimiento en el portal del SAT: CÓMO TRAMITAR UN CERTIFICADO DE SELLO DIGITAL (CSD).
Ubicación del servicio.
Las URLs donde se encuentra la definición del Web Service (WSDL) para cada uno de los ambientes son:
Ambiente | Ubicación del WSDL del servicio |
---|---|
Pruebas | https://oat.reachcore.com/api/ws/6.0/pacservices/Consulta.svc/basic?wsdl |
Producción | https://go.reachcore.com/api/ws/6.0/pacServices/Consulta.svc/basic?wsdl |
Método [ConsultaEstadoCFDI
]
En este método se podrá realizar la solicitud de Consulta de Estado de un CFDI. Este método no requiere de la firma de una petición con el CSD del Receptor, pero solicita información del Comprobante.
Solicitud Consulta Estado
Elemento | Uso | Descripción |
---|---|---|
ApiKey | Requerido | Identificador de autenticación, que se genera en el portal de Reachcore. |
RfcEmisor | Requerido | Indica el RFC Emisor a consultar. |
RfcReceptor | Requerido | Indica el RFC Receptor a consultar. |
Total | Requerido | Indica el Total del Comprobante a consultar. |
Uuid | Requerido | Indica el UUID o Folio Fiscal del Comprobante a consultar. |
Estructura de solicitud:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<soapenv:Header>
<cus:ApiKey>000...999</cus:ApiKey>
</soapenv:Header>
<soapenv:Body>
<urn:ConsultaEstadoCFDIRequest>
<urn:RfcEmisor>CALJ581101M37</urn:RfcEmisor>
<urn:RfcReceptor>XAXX010101000</urn:RfcReceptor>
<urn:Total>10000.00</urn:Total>
<urn:Uuid>e99aff16-b7ef-4ea5-9c57-61c8d479b63f</urn:Uuid>
</urn:ConsultaEstadoCFDIRequest>
</soapenv:Body>
</soapenv:Envelope>
Respuesta Consulta Estado
Elemento | Descripción |
---|---|
TransactionId | Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore. |
Error | Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es: Code : código de error. Message : Descripción del código de error. |
Result | La respuesta a la consulta de estado de un CfDI en el SAT. |
Ejemplo de respuesta:
<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">
<ConsultaEstadoCFDIResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<TransactionId>0da4d3ca-81b6-452f-aef1-017fa2cfeb2e</TransactionId>
<ConsultaResult>
<a:CodigoEstatus>S - Comprobante obtenido satisfactoriamente.</a:CodigoEstatus>
<a:EsCancelable>Cancelable con aceptación</a:EsCancelable>
<a:Estado>Vigente</a:Estado>
<a:EstatusCancelacion>En proceso</a:EstatusCancelacion>
</ConsultaResult>
</ConsultaEstadoCFDIResponse>
</s:Body>
</s:Envelope>
Códigos de Respuesta del SAT para el Servicio de Consulta Estado de un CFDI
Lista de mensajes posibles en elemento CodigoEstatus
Mensaje | Descripción |
---|---|
S - Comprobante obtenido satisfactoriamente | |
N 601: La representación impresa proporcionada no es valida | Este código de respuesta se presentará cuando en la petición de validación no se haya respetado el formato definido. |
N 602: Comprobante no encontrado |
Lista de mensajes posibles en elemento EsCancelable
Mensaje | Descripción |
---|---|
Cancelable sin aceptación | El Comprobante puede ser cancelado sin necesidad de solicitar autorización al Receptor |
Cancelable con aceptación | El Comprobante puede ser cancelado pero necesita autorización por parte del Receptor |
No cancelable | El Comprobante no puede ser cancelado |
Lista de mensajes posibles en elemento Estado
Mensaje | Descripción |
---|---|
Vigente | El Comprobante se encuentra Vigente en el SAT |
Cancelado | El Comprobante se encuentra Cancelado en el SAT |
No Encontrado | El Comprobante no ha podido ser encontrado en la base del SAT |
Lista de mensajes posibles en elemento EstatusCancelacion
Mensaje | Descripción |
---|---|
Cancelado sin aceptación | El Comprobante se canceló sin que el Receptor emitiera una respuesta |
Cancelado con aceptación | El Receptor del Comprobante aceptó la cancelación |
Plazo vencido | Expiró el tiempo de espera para recibir respuesta por parte del Receptor |
En proceso | Existen peticiones de cancelación en curso para el Comprobante consultado |
Solicitud rechazada | El Receptor del Comprobante rechazó la cancelación |
Método [ConsultaPeticionesPendientes
]
En este método se podrá realizar la solicitud de consulta de CFDI Pendientes de respuesta de cancelación. Para poder utilizar este método, se requiere que el CSD del Receptor del CFDI se encuentre registrado en Reachcore para que de esta forma se pueda firmar la solicitud de cancelación.
Solicitud Consulta Peticiones Pendientes
Elemento | Uso | Descripción |
---|---|---|
ApiKey | Requerido | Identificador de autenticación, que se genera en el portal de Reachcore. |
RfcReceptor | Requerido | Indica el RFC Receptor del Comprobante a consultar y se relaciona con el CSD con el que se llevará a cabo la firma electrónica de la solicitud de consulta. |
Estructura de solicitud:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<soapenv:Header>
<cus:ApiKey>000...999</cus:ApiKey>
</soapenv:Header>
<soapenv:Body>
<urn:PeticionesPendientesRequest>
<urn:RfcReceptor>BAJF541014RB3</urn:RfcReceptor>
</urn:PeticionesPendientesRequest>
</soapenv:Body>
</soapenv:Envelope>
Respuesta de Consulta Peticiones Pendientes
Elemento | Descripción |
---|---|
CodEstatus | Indica el estado de la consulta |
UUID | Indica los UUID de los Comprobantes pendientes de respuesta de cancelación que tenga el Receptor |
<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">
<PeticionesPendientesResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<TransactionId>3562dc5c-e996-4cbf-8de4-6a2a36a18440</TransactionId>
<ObtenerPeticionesPendientesResult CodEstatus="1100">
<UUID>
<guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
<guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
<guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
<guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
<guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
<guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
<guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
<guid>cb349854-5aac-4d72-b796-cbab9b2bf760</guid>
<guid>dffd810e-503d-404c-ad49-37bcee68ecbd</guid>
<guid>a2c74a90-4bb2-480e-ac9e-1cb550b1563a</guid>
<guid>cc6bd9cc-43db-4560-8eec-5d9aad375faa</guid>
<guid>bf546196-1778-4b79-af2e-4ee5e0b3d6df</guid>
<guid>39140bd4-1d11-46db-8cfb-3c28234f9fcb</guid>
<guid>fcc02812-c1ad-42f2-a3e7-f06bb9f3d6c1</guid>
</UUID>
</ObtenerPeticionesPendientesResult>
</PeticionesPendientesResponse>
</s:Body>
</s:Envelope>
Códigos de respuesta del Servicio del SAT para el método de ConsultaPeticionesPendientes
Código | Descripción del código | Observaciones |
---|---|---|
300 | Usuario no valido | Este código de error se regresa cuando la autentificación del usuario no fue exitosa. |
301 | XML mal formado | Este código de error se regresa cuando el request posee información invalida, ejemplo: un RFC de receptor no válido. |
1001 | Se obtuvieron las peticiones del RFC Receptor de forma exitosa | |
1101 | No existen peticiones pendientes 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 |
Método [ConsultaUUIDRelacionados
]
En este método se podrá realizar la solicitud de consulta de CFDI Relacionados a un folio fiscal. Para poder utilizar este método, se requiere que el CSD del Receptor del CFDI se encuentre registrado en Reachcore para que de esta forma se pueda firmar la solicitud de cancelación.
Solicitud de Consulta CFDI Relacionados
Elemento | Uso | Descripción |
---|---|---|
ApiKey | Requerido | Identificador de autenticación, que se genera en el portal de Reachcore. |
Uuid | Requerido | Folio fiscal del Comprobante a consultar. El folio fiscal debe tener el formato de GUID válido, descrito por la siguiente expresión regular: [a-f0-9A-F]{8}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{12} Ejemplo: 18982836-822c-417c-b235-1f596117fad8 |
RfcReceptor | Requerido | Indica el RFC Receptor del Comprobante a consultar y se relaciona con el CSD con el que se llevará a cabo la firma electrónica de la solicitud de consulta. |
Ejemplo de solicitud:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<soapenv:Header>
<cus:ApiKey>000...999</cus:ApiKey>
</soapenv:Header>
<soapenv:Body>
<urn:ConsultaCFDIRelacionadosRequest>
<urn:Uuid>BA72F298-1118-45F2-B73D-AE3700F5E003</urn:Uuid>
<urn:RfcReceptor>LAN7008173R5</urn:RfcReceptor>
</urn:ConsultaCFDIRelacionadosRequest>
</soapenv:Body>
</soapenv:Envelope>
Respuesta Consulta CFDI Relacionados
Elemento | Descripción |
---|---|
TransactionId | Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore. |
Error | Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es: Code : código de error. Message : Descripción del código de error. |
Result | La respuesta en formato XML generada por el SAT, la cual indica el resultado de la operación de la solicitud de consulta de CFDI relacionados. |
Ejemplo de respuesta:
<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">
<ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<TransactionId>77c46817-001b-4f46-b95c-c477859be32e</TransactionId>
<CodEstatus>2000</CodEstatus>
<UuidsRelacionadosPadres>
<UuidPadre>
<Uuid>ba72f298-1118-45f2-b73d-ae3700f5e003</Uuid>
<RfcEmisor>AAA010101AAA</RfcEmisor>
<RfcReceptor>LAN7008173R5</RfcReceptor>
</UuidPadre>
</UuidsRelacionadosPadres>
<UuidsRelacionadosHijos>
<UuidRelacionado>
<Uuid>fc62c1dd-a063-449c-9b2a-0448862d349f</Uuid>
<RfcEmisor>AAA010101AAA</RfcEmisor>
<RfcReceptor>LAN7008173R5</RfcReceptor>
</UuidRelacionado>
</UuidsRelacionadosHijos>
</ConsultaCFDIRelacionadosResponse>
</s:Body>
</s:Envelope>
Método [ConsultaUUIDRelacionadosFirmada
]: Consulta de CFDI Relacionado por medio de petición firmada de origen
Este método se utiliza para solicitar la consulta de CFDI relacionados a un Folio Fiscal específico; sin embargo, a diferencia del método ConsultaCFDIRelacionados
, cuando no es posible registrar el CSD del Receptor en Reachcore, el XML de la petición de consulta de CFDI relacionados firmada con el CSD del Receptor es enviada en la solicitud de este método, conforme a lo definido por el SAT para la solicitud de consulta. La respuesta de esta operación es idéntica a la del método ConsultaCFDIRelacionados
: la respuesta de consulta dentro del SAT.
Solicitud ConsultaCFDIRelacionadosFirmada
Elemento | Uso | Descripción |
---|---|---|
ApiKey | Requerido | Identificador de autenticación, que se genera en el portal de Reachcore. |
SolicitudFirmada | Requerido | XML con la solicitud de consulta conforme a la estructura especificada por el SAT, indicando: Estos datos van firmados electrónicamente con la llave privada del Receptor. Para referencia de cómo llevar a cabo el firmado consulta el artículo: ¿Cómo firmar una solicitud de cancelación con la llave privada del emisor? |
Ejemplo de Solicitud:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<soapenv:Header>
<cus:ApiKey>000...999</cus:ApiKey>
</soapenv:Header>
<soapenv:Body>
<urn:ConsultaCFDIRelacionadosRequestFirmado>
<urn:SolicitudFirmada><![CDATA[<PeticionConsultaRelacionados xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Uuid="ca2a3b53-f384-4977-9e0f-093ba5734528" RfcReceptor="LAN7008173R5" RfcPacEnviaSolicitud="ASE0201179X0" xmlns="http://cancelacfd.sat.gob.mx"><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"><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>NdQsgRqNObUvJVZ9anZVhQ0QwIs=</DigestValue></Reference></SignedInfo><SignatureValue>gf05Sf8tu9DjSdRr8JhjTYEEbdPeqdseV5akDQklAd/lrhPGrqiaLhj1tml9EjpzeeXTpc2Y1rubPGiPXngByly1nw/G/CB2zOHaCDG2xRV3mU+e2+d/c56yB+sKUtRV/FpYoI9NXCXgX7JskT/3ETGtNcjJXMOsXvQLOQRcQYAMqI9QYCiVqOG8TcMy4n91Tap8Q3mYLc48gP3FFK6NrxFnmFI3IVaorK2OspHjQ8PXArbMGNNvSP0lZpj/e4IgDA/J2q9GQMrmYF6TvsWEGPWeOs/DWnd/3wGnK6vmgn2eUJlFHPhMqBlcFWGGUmrQS/Dt8kt2QeAgLVMeEJjsHA==</SignatureValue><KeyInfo><X509Data><X509IssuerSerial><X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoacán, S=Distrito Federal, C=MX, PostalCode=06300, STREET="Av. Hidalgo 77, Col. Guerrero", E=asisnet@pruebas.sat.gob.mx, OU=Administración de Seguridad de la Información, O=Servicio de Administración Tributaria, CN=A.C. 2 de pruebas(4096)</X509IssuerName><X509SerialNumber>286524172099382162235533054548081509963388170549</X509SerialNumber></X509IssuerSerial><X509Certificate>MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7/w=</X509Certificate></X509Data></KeyInfo></Signature></PeticionConsultaRelacionados>]]></urn:SolicitudFirmada>
</urn:ConsultaCFDIRelacionadosRequestFirmado>
</soapenv:Body>
</soapenv:Envelope>
Respuesta ConsultaCFDIRelacionadosResponse
Elemento | Descripción |
---|---|
TransactionId | Identificador de transacción dentro de reachcore. Si existen errores, se debe proporcionar este dato al equipo de Soporte Reachcore. |
Error | Este nodo se regresa sólo cuando hay errores en la petición. La información que contiene este nodo es: Code : código de error. Message : Descripción del código de error. |
Result | La respuesta en formato XML generada por el SAT, la cual indica el resultado de la operación de la solicitud de consulta de CFDI relacionados. Esta respuesta se entrega dentro de un elemento <![CDATA[...]]> . |
Ejemplo de Respuesta:
<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">
<ConsultaCFDIRelacionadosResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<TransactionId>5926b0d2-6671-48f1-bc83-1486b0f9099c</TransactionId>
<CodEstatus>2001</CodEstatus>
<UuidsRelacionadosPadres>
<UuidPadre>
<Uuid>ca2a3b53-f384-4977-9e0f-093ba5734528</Uuid>
<RfcEmisor>AAA010101AAA</RfcEmisor>
<RfcReceptor>LAN7008173R5</RfcReceptor>
</UuidPadre>
</UuidsRelacionadosPadres>
</ConsultaCFDIRelacionadosResponse>
</s:Body>
</s:Envelope>
Códigos de respuesta del Servicio del SAT para los métodos de ConsultaCFDIRelacionados
Código | Descripción del código | Observaciones |
---|---|---|
2000 | Existen CFDI relacionados al folio fiscal | Este código de respuesta se presentará cuando la petición de consulta encuentre documentos relacionados al UUID consultado. |
2001 | No existen CFDI relacionados al folio fiscal | Este código de respuesta se presentará cuando el UUID consultado no contenga documentos relacionados a él. |
2002 | El folio fiscal no pertenece al Receptor | Este código de respuesta se presentará cuando el RFC del receptor no corresponda al UUID consultado. |
1101 | 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. |
Códigos de error propios de la plataforma Reachcore
Código | Descripción del código | Observaciones |
---|---|---|
100 | API Key Requerida | El elemento ApiKey esta vacío o contiene espacios. |
101 | API Key no válida | El API Key no existe en Reachcore. |
102 | API Key no tiene privilegios | La cuenta Reachcore no tiene activado el servicio de consulta de CFDI relacionados para un CFDI. Por favor contacta a Reachcore para solicitar informes de cómo activar esta funcionalidad. |
201 | Solicitud requerida | El elemento SolicitudFirmada esta vacío. |
202 | Solicitud no es un XML válido | No se puede leer como XML el contenido del elemento SolicitudFirmada. |
205 | RFC Receptor no válido | El RFC Receptor no cumple con la expresión regular. |
206 | Namespace no valido | No se está usando el namespace correcto para el nodo raíz. |
207 | Prefijo no válido | No se está usando el prefijo can para el namespace del comprobante. |
300 | Autenticación no válida | Este código de respuesta se presentará cuando la petición de consulta obtenga una autenticación no válida dentro del SAT |
301 | Certificado no corresponde al RFC Receptor | El RFC Receptor no es el mismo RFC del CSD. |
302 | El certificado no es CSD | El comprobante esta sellado con un certificado FIEL. |
303 | Certificado no emitido por el SAT | El CSD no está firmado por algún certificado raíz del SAT. |
304 | Certificado no registrado en LCO | El certificado del receptor no esta registrado en la Lista de Contribuyentes con Obligación (LCO) publicada por el SAT. |
305 | Certificado de receptor no existente | El número del certificado CSD no existe para ese RFC Receptor. |
306 | Comprobante fuera de vigencia del certificado | La fecha de expedición del comprobante está fuera del rango de vigencia del certificado. |
307 | Certificado de receptor no vigente | La fecha de expedición del comprobante está fuera del rango de vigencia del certificado. |
308 | Certificado de receptor revocado | El certificado está actualmente revocado en la LCO del SAT. |
999 | Error interno del servicio. | Error de la plataforma de Reachcore |
Método [LotesCancelacion
]
En este método se podrá realizar la solicitud de Consulta los identificadores de lote de cancelación que se generaron en un periodo específico. Este método permite obtener los identificadores de lote de cancelación que se entregan al depositar un archivo de lote de cancelación a través del SFTP o del portal de emisión de Reachcore.
Solicitud de Consulta de Identificador de Lote de Cancelacion
Elemento | Uso | Descripción |
---|---|---|
ApiKey | Requerido | Identificador de autenticación, que se genera en el portal de Reachcore. |
TipoDocumento | Requerido | Especifica el tipo de lote de documentos enviados. Valores permitidos: cfdi o retenciones |
FechaInicial | Requerido | Fecha en formato yyyy-mm-dd donde inicia el periodo de consulta. |
FechaFinal | Requerido | Fecha en formato yyyy-mm-dd donde termina el periodo de consulta. |
Estructura de solicitud:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cus="http://www.reachcore.com/CFDI/customHeaders" xmlns:urn="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<soapenv:Header>
<cus:ApiKey>?</cus:ApiKey>
</soapenv:Header>
<soapenv:Body>
<urn:ConsultaIdLoteCancelacionRequest>
<urn:TipoDocumento>cfdi</urn:TipoDocumento>
<urn:FechaInicial>2021-06-01</urn:FechaInicial>
<urn:FechaFinal>2021-06-30</urn:FechaFinal>
</urn:ConsultaIdLoteCancelacionRequest>
</soapenv:Body>
</soapenv:Envelope>
Respuesta ConsultaIdLoteCancelacion
Respuesta exitosa
Elemento | Descripción |
---|---|
Lotes | Agrupador de los distintos lotes de cancelación. |
Lote | Elemento que contiene la información asociada al lote de cancelación. |
Atributos del nodo Lote
Atributo | Descripción |
---|---|
Identificador | ID del lote de cancelación |
Tipo | Tipo de documentos a los que pertenece el lote (CFDI o Retenciones) |
Rfc | RFC del Emisor al que pertenece el lote de cancelación. Para el caso de un lote de cancelación de Sector Primario, se regresa el valor PSECFDI |
Fecha | Fecha en que se recibió el lote de cancelación |
Estatus | Estado del lote de cancelación, puede ser En Proceso , Abortado , o Finalizado . |
Cancelados | Una vez que se terminó de procesar el lote de cancelación, indica la cantidad de documentos cancelados. |
NoCancelados | Una vez que se terminó de procesar el lote de cancelación, indica la cantidad de documentos que no pudieron ser cancelados. |
Ejemplo de respuesta para una consulta de CFDI:
<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">
<ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<Lotes>
<Lote Identificador="5d0cf1f5-1247-4c71-87e8-82a2ca110859" Tipo="CFDI" Rfc="PSECFDI" Fecha="2021-06-01T14:34:20" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
<Lote Identificador="a09885ea-cd6f-47c6-85c6-999d95e19bb9" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T14:45:33" Estatus="Abortado" Cancelados="0" NoCancelados="0"/>
<Lote Identificador="49866688-a986-4469-aef5-b39bab7a2235" Tipo="CFDI" Rfc="EKU9003173C9" Fecha="2021-06-01T19:28:16" Estatus="Finalizado" Cancelados="0" NoCancelados="1"/>
</Lotes>
</ConsultaIdLoteCancelacionResponse>
</s:Body>
</s:Envelope>
Ejemplo de respuesta para una consulta de Retenciones:
<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">
<ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<Lotes>
<Lote Identificador="43a06c26-6567-4e34-b16c-0bc4fbbc7cb7" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T16:40:13" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
<Lote Identificador="4323c330-4379-4f45-9d63-99b7483e3d7b" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:25:06" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
<Lote Identificador="fa6422d3-134c-4d1d-ba3e-26462745599f" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:27:48" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
<Lote Identificador="91bbe91d-4bc2-4d02-946f-06b9d6a3bd05" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:29:54" Estatus="Finalizado" Cancelados="7" NoCancelados="0"/>
<Lote Identificador="84fa4c06-7dcc-4c05-88ba-7bc0494ef9dc" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-20T19:34:23" Estatus="Finalizado" Cancelados="10" NoCancelados="0"/>
<Lote Identificador="90f3e8df-67ae-4b95-a223-3bf6cae29833" Tipo="Retenciones" Rfc="EKU9003173C9" Fecha="2021-04-21T11:19:34" Estatus="Abortado" Cancelados="1" NoCancelados="0"/>
<Lote Identificador="60644b9f-5af5-4068-8d4e-d4a7c96a111f" Tipo="Retenciones" Rfc="AAA010101AAA" Fecha="2021-04-26T20:44:45" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
<Lote Identificador="2720ac13-6c58-425d-8028-19edb870e510" Tipo="Retenciones" Rfc="XOJI740919U48" Fecha="2021-04-26T21:47:18" Estatus="Finalizado" Cancelados="1" NoCancelados="0"/>
</Lotes>
</ConsultaIdLoteCancelacionResponse>
</s:Body>
</s:Envelope>
Respuesta con errores en la petición
Elemento | Descripción |
---|---|
Error | Agrupador de los distintos errores en la petición. |
Code | Indica el tipo de error encontrado. |
Message | Proporciona una descripción simple del motivo de error. |
Ejemplos de respuesta con errores:
<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">
<ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<Error>
<Code>TipoDocumento</Code>
<Message>El tipo de documento es inválido.</Message>
</Error>
</ConsultaIdLoteCancelacionResponse>
</s:Body>
</s:Envelope>
<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">
<ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<Error>
<Code>Fecha</Code>
<Message>La fecha inicial [2022-04-01] debe ser menor a la fecha final [2021-06-30].</Message>
</Error>
</ConsultaIdLoteCancelacionResponse>
</s:Body>
</s:Envelope>
<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">
<ConsultaIdLoteCancelacionResponse xmlns="urn:schemas.reachcore.com:pacservices:6.0:ConsultaSAT">
<Error>
<Code>Fecha</Code>
<Message>La fecha inicial [2021-06-30] debe ser menor a la fecha final [2021-05-30].</Message>
</Error>
</ConsultaIdLoteCancelacionResponse>
</s:Body>
</s:Envelope>
Para mayor información o aclaración de dudas relacionadas con esta guía, por favor envía un correo a MEX-soporte@sovos.com.
Regresar