1. Home
  2. Servicios
  3. Cancelaciones
  4. Consulta CFDI relacionados antes de cancelar

Consulta CFDI relacionados antes de cancelar

En el nuevo esquema de cancelación, no es posible cancelar una factura si esta tiene facturas que la estén relacionando. Mediante este servicio podrás consultar los CFDI que estén relacionados a una factura.

Documentación teórica

https://developers.sw.com.mx/knowledge-base/como-cancelar-emisor/


Url Productivo:

https://services.sw.com.mx

Ruta
Operación
Descripción
/relations/csd
POST Ruta para obtener cfdi relacionados por CSD.
/relations/pfx
POST Ruta para obtener cfdi relacionados por PFX.
/relations/{rfc}/{uuid}
POST Ruta para obtener cfdi relacionados por RFC y UUID.

Los servicios para obtener relaciones son servicios REST.

Obtener relaciones por CSD


Como su nombre lo indica, este servicio recibe todos los elementos que componen el CSD los cuales son los siguientes:

  • Certificado (.cer)
  • Key (.key)
  • Password del archivo key
  • RFC Emisor

Asi como el UUID del CFDI al que se desea consultar las relaciones.

Esto ya que nuestro servidor generara el acuse de cancelación.
Paso 1: Obtener token de acceso, o en su defecto usar token infinito
Primeramente se deberá autenticar en nuestros servicios en orden de obtener token de acceso, o si se desea,  se puede usar el token infinito.
Paso 2: Enviar datos necesarios
Se envían los datos necesarios, que básicamente es el CSD del Emisor que desea consultar un CFDI, así como el RFC de dicho Emisor, el uuid correspondientes al CFDI que se desea consultar,  y por supuesto el token de acceso anteriormente generado.

Cabe mencionar que los archivos .cer y .key,  al ser binarios, deberán enviarse en formato base64 para que podamos procesarlos en nuestro servidor.

HTTP Request por CSD

HTTP Response por CSD

Obtener relaciones con las librerias por CSD


‘ tab_head_2=’JAVA’ tab_content_2=’

Ir al Repositorio de Java en GitHub

‘ tab_head_3=’PHP’ tab_content_3=’

Ir al Repositorio de PHP en GitHub

‘ tab_head_4=’Node.js’ tab_content_4=’

Ir al Repositorio de Node.js en GitHub

‘ id=”” class=”” style=”” ]

Obtener relaciones por PFX


Como su nombre lo indica, este servicio recibe todos los elementos que componen el PFX los cuales son los siguientes:

  • PFX
  • Password del archivo key
  • RFC Emisor

Asi como el UUID del CFDI al que se desea consultar las relaciones.

Esto ya que nuestro servidor generara el acuse de cancelación.
Paso 1: Obtener token de acceso, o en su defecto usar token infinito
Primeramente se deberá autenticar en nuestros servicios en orden de obtener token de acceso, o si se desea,  se puede usar el token infinito.
Paso 2: Enviar datos necesarios
Se envían los datos necesarios para la consulta, que básicamente es el PFX del Emisor que desea consultar un CFDI, así como el RFC de dicho Emisor, el uuid correspondientes al CFDI que se desea consultar,  y por supuesto el token de acceso anteriormente generado.

Cabe mencionar que los archivos .pfx,  al ser binarios, deberán enviarse en formato base64 para que podamos procesarlos en nuestro servidor.

HTTP Request por PFX

HTTP Response por PFX



Obtener relaciones por UUID


Para utilizar este servicio es necesario cargar los certificados en nuestro administrador de timbres, así mismo se proporcionan los siguientes elementos:

  • UUID
  • RFC Emisor

Esto ya que nuestro servidor generara el acuse de cancelación.
Paso 1: Obtener token de acceso, o en su defecto usar token infinito
Primeramente se deberá autenticar en nuestros servicios en orden de obtener token de acceso, o si se desea,  se puede usar el token infinito.
Paso 2: Enviar datos necesarios
Se envían los datos necesarios para la consulta, que básicamente es el CSD del Emisor que desea consultar un CFDI, así como el RFC de dicho Emisor, el uuid correspondientes al CFDI que se desea consultar,  y por supuesto el token de acceso anteriormente generado.

Es necesario subir los certificados a nuestro administrador de timbres para poder consumir este servicio .

Administrador de Pruebas:

https://pruebascliente.smartweb.com.mx


Administrador de Productivo:

https://cliente.smartweb.com.mx

HTTP Request por UUID

HTTP Response por UUID

Respuestas

Todos los response retornan la misma estructura en caso de error o en caso de petición satisfactoria, las cuales son las siguientes:

Tipos de respuesta

En caso de una respuesta exitosa, se regresará un 200. En caso de una respuesta no exitosa, se regresará un código diferente de 200, el código puede variar dependiendo del problema dado.

Respuesta exitosa

En este caso se recibe un mensaje JSON, el cual contiene los siguientes datos:

  • uuidConsultado: El uuid al que se consultan los relacionados.
  • Resultado: Mensaje que retorna el SAT.
  • uuidsRelacionadosPadres: Un arreglo de objetos uuid padre, el cual tiene las propiedades: uuid, rfcEmisor, rfcReceptor.
  • uuidsRelacionadosHijos: Un arreglo de objetos uuid hijo, el cual tiene las propiedades: uuid, rfcEmisor, rfcReceptor

Respuestas no exitosas

Respuestas no exitosas/Relacionados por UUID


Respuestas no exitosas/Cancelación por PFX


Respuestas no exitosas/Relacionados por CSD


Respuestas no exitosas/Cancelación por XML

Códigos de respuesta.

Codigo
Mensaje
Descripción

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 Emisro.  Este código de respuesta se presentará cuando el RFC del Emisor no corresponda al UUID consultado.

Para realizar la integración con nuestros servicios recomendamos utilizar POSTMAN , facilita las pruebas previas a la codificación.
Puedes importar el archivo POSTMAN-collection que proporcionamos al final del articulo para su descarga en POSTMAN para que puedas realizar pruebas funcionales de nuestro servicio.

Updated on abril 4, 2022

Article Attachments

Was this article helpful?

Related Articles