Primeros pasos

Lo siguiente es una guía sugerida para realizar una integración exitosa al servicio de timbrado de Prodigia.

1. Registro a la plataforma Pade: el proceso se detalla en la sección Manuales.
2. Conocer el método de timbrado: en la sección "Método de Timbrado" del servicio SOAP o el servicio REST encontrarás el detalle de cómo realizar el llamado de timbrado.
3. Conocer la funcionalidad adicional(opciones) que utilizarás: una opción es funcionalidad adicional que realiza el servicio de timbrado en base a tu necesidad. Estas se envían como parámetro durante el llamado de timbrado, Las opciones más comunes se utilizan para cálculo del sello del comprobante y generación de PDF.

   La lista completa de opciones la puedes encontrar en la sección Opciones del Servicio de Timbrado.

En el caso de que se requiera que el sello se calcule de nuestro lado, es necesario cargar el certificado de sello digital (CSD) el cual será almacenado en base de datos, para realizar este proceso contamos con un manual de usuario.

Recomendaciones

Establecer un timeout adecuado: la duración del proceso de timbrado depende de las opciones establecidas, el tamaño del comprobante,entre otras cosas. Si bien el promedio de timbrado de un comprobante va de 350ms a 500ms, recomendamos establecer un timeout de 60 segundos.

Crear un usuario para el webservice y otro para el portal: por seguridad se recomienda generar diferentes usuarios en plataforma para utilizar el servicio de webservice y portal.

Guardar muy bien el código de cliente: es importante mantenerlo seguro para restablecer su contraseña, solo se hace llegar mediante correo electrónico.

Duplicar comprobantes: Por reglas del SAT, un comprobante con exactamente la misma información no puede ser duplicado. Sin embargo, si dos comprobantes tienen 1 segundo de diferencia en la fecha de emisión o algún otro dato tenga un caracter diferente, es fiscalmente otro comprobante. En el servicio de Prodigia no pueden duplicarse comprobantes mientras estos cuenten con exactamente la misma información. Si hay una variación de tan solo 1 dígito o caracter, fiscalmente es un comprobante nuevo.

Ambiente de producción este ambiente se utiliza para realizar el proceso de timbrado y la obtención de sus CFDI's, mismos que se reflejan ante el SAT, asi como también los diferentes métodos y opciones del servicio de timbrado y cancelación. La URL de este ambiente varia según el tipo de conexión al servicio que se vaya a utilizar (SOAP o REST).

• Para conocer el proceso de conexión de su interés, deberá ir a la sección del Servicio deseado. Todas nuestras url de este ambiente inician con https://timbrado.pade.mx

Infraestructura y Ambientes Separados

Es importante señalar que los diferentes tipos ambientes, no comparten infraestructura. Cada uno opera de forma completamente independiente, lo que incluye:

• Bases de datos separadas.
• Infraestructura específica para cada ambiente.
• URLs exclusivas que permiten el acceso a los servicios correspondientes de acuerdo con el tipo de ambiente.
• Usuarios y correos no coexisten.

Conexión al servicio de integración de timbrado CFDI (SOAP)

El servicio se encuentra disponible en una dirección URL pública:

https://timbrado.pade.mx/PadeServ/IntegracionCfdi?WSDL

Dentro de este servicio se encuentra disponible la integración al servicio de timbrado de la versión más actual del CFDI 4.0 Parámetros de conexión al servicio.

Método procesarArchivoConCSD

En caso de requerir enviar los archivos del certificado del sello digital (CSD) en la petición y no calcularlos previamente ni solicitar que se calculen por parte de prodigia al enviar la petición, puede utilizarse el método procesarArchivoConCSD donde se pueden enviar los archivos del CSD codificados en base64 para la construcción del sello del comprobante, como se aprecia en la siguiente petición:

En caso de alguna duda sobre el catálogo de errores. favor de revisar la sección de códigos.

Parámetros

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario *
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd *
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• datos (comprobante a timbrar) *
  • Es el CSV que se requiere timbrar, mismo que deberá estar previamente llenado con la estructura correcta.
• opciones
  • CALCULAR_SELLO,
  • PLUGIN_PROCESO:GENERICO_CFDI40:1.0 - Este plugin se utiliza para procesar el archivo csv para poder realizar un cfdi con la versión 4.0.

  Básicamente las opciones que se utilizan de igual forma en el servicio de timbrado.

• prueba
• Parámetro para realizar la petición en modo prueba, deberá especificarse como true (modo prueba) o false (timbrado real), si no agregamos el parámetro, se toma como timbrado real.
• key*
• Arreglo de bytes Llave privada correspondiente al certificado.
• keyPass*
• Contraseña de la llave privada.
• cert*
• Arreglo de bytes con el archivo del certificado de sello digital. Se debe enviar el archivo binario tal como se obtuvo del SAT (formato CER).

NOTA: Para conocer las guías de llenado de los diferentes tipos de comprobantes puede consultar la información oficial que el SAT ofrece.

Ejemplo de Request

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
 <soapenv:Header/>
   <soapenv:Body>
    <int:procesarArchivoConCSD>
       	<contrato>CONTRATO</contrato>
        <usuario>USUARIO</usuario>
        <passwd>CONTRASEÑA</passwd>
        <prueba>true</prueba>
	<datos>
		<![CDATA[CFDI|4.0|TEST|77|2022-10-30T07:45:25||99|||Credito|21097.50||MXN|1|24473.10|I|01|PPD|83299|
		INFG|04|05|2022
		EMIS|RFC_EMISOR|NOMBRE_EMISOR|610||
		RECE|RFC_RECEPTOR|NOMBRE_RECEPTOR|40060|||605|D03|
		CONC|30141514|BOVE-020342|50|H87|PIEZA|APLICACIÓN DE Ñ PERALTADA TIPO 10 68x122x12, T1 P4|102.50000|5125||02
		CIMT|5125|002|Tasa|0.160000|820
		CIMR|5125|002|Tasa|0.000001|0
		CONC|30141514|BOVE-020487|60|H87|PIEZA|BOVEDILLA  TIPO 10 68x122x14.5, T1 P6.5|123.85000|7431||02
		CIMT|7431|002|Tasa|0.160000|1188.96
		CIMR|7431|002|Tasa|0.000001|0
		CONC|30141514|BOVE-020249|50|H87|PIEZA|BOVEDILÑÓLA TIPO 10 68x122x20, T1 P5|170.83000|8541.5||02
		CIMT|8541.5|002|Tasa|0.160000|1366.64
		CIMR|8541.5|002|Tasa|0.000001|0
		IMPU|0|3375.60
		IMPR|002|0
		IMPT|21097.5|002|Tasa|0.160000|3375.60]]>
	</datos>
   	<cert>CERTIFICADO</cert>
        <key>KEY</key>
        <keyPass>CONTRASEÑA</keyPass>
        <opciones>PLUGIN_PROCESO:GENERICO_CFDI40:1.0</opciones>
        <opciones>CALCULAR_SELLO</opciones>
      </int:procesarArchivoConCSD>
    </soapenv:Body>
 </soapenv:Envelope>
									
								

+Response

		
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
       <ns2:procesarArchivoConCSDResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
          <return><![CDATA[ <?xml version="1.0" encoding="UTF-8"?>
             <servicioTimbrado>
                <id>5db837b6-aba9-404c-9e52-34a84d3798ab</id>
                <timbradoOk>true</timbradoOk>
                <contrato>CONTRATO</contrato>
                <codigo>0</codigo>
                <version>1.1</version>
                <UUID>UUID</UUID>
                <FechaTimbrado>FECHA_TIMBRADO</FechaTimbrado>
                <selloCFD>SELLO_CFD</selloCFD>
                <noCertificadoSAT>CERTIFICADO_SAT</noCertificadoSAT>
                <selloSAT>SELLO_SAT</selloSAT>
                <xmlBase64>PD94bWwgdMTlFtR0diTzQ0Q2Q5b1RvT0MrQ2F3cE9zUXR2enF3R0xRRERmYkp0d0k4dUJFb0NlT2JvN2Mvc…
                bz48L3BhZ28yMDpQYWdvcz48L2NmZGk6Q29tcGxlbWVudG8+PC9jZmRpOkNvbXByb2JhbnRlPg== </xmlBase64>
             </servicioTimbrado>]]></return>
       </ns2:procesarArchivoConCSDResponse>
    </S:Body>
 </S:Envelope>
 	
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación:

Método procesarArchivo

El método permite generar el timbrado de un comprobante a partir del archivo de intercambio en formato csv enviado en el parámetro datos en la petición.

En caso de alguna duda sobre el catálogo de errores. favor de revisar la sección de códigos.

Parámetros

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario*
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd*
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• datos (comprobante a timbrar) *
• Es el CSV que se requiere timbrar, mismo que deberá estar previamente llenado con la estructura correcta.
• opciones
• CALCULAR_SELLO,
• PLUGIN_PROCESO:GENERICO_CFDI40:1.0 - Este plugin se utiliza para procesar el archivo csv para poder realizar un cfdi con la versión 4.0.
• prueba
• Parámetro para realizar la petición en modo prueba, deberá especificarse como true (modo prueba) o false (timbrado real), si no agregamos el parámetro, se toma como timbrado real.

NOTA: Para conocer las guías de llenado de los diferentes tipos de comprobantes puede consultar la información oficial que el SAT ofrece.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
   <soapenv:Header/>
    <soapenv:Body>
      <int:procesarArchivo>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA</passwd>
         <prueba>true</prueba>
         <datos><![CDATA[CFDI|4.0|TEST|77|2022-10-30T07:45:25||99|||Credito|21097.50||MXN|1|24473.10|I|01|PPD|83299|
		INFG|04|05|2022
		EMIS|RFC_EMISOR|NOMBRE_EMISOR|610||
		RECE|RFC_RECEPTOR|NOMBRE_RECEPTOR|40060|||605|D03|
		CONC|30141514|BOVE-020342|50|H87|PIEZA|APLICACIÓN DE Ñ PERALTADA TIPO 10 68x122x12, T1 P4|102.50000|5125||02
		CIMT|5125|002|Tasa|0.160000|820
		CIMR|5125|002|Tasa|0.000001|0
		CONC|30141514|BOVE-020487|60|H87|PIEZA|BOVEDILLA  TIPO 10 68x122x14.5, T1 P6.5|123.85000|7431||02
		CIMT|7431|002|Tasa|0.160000|1188.96
		CIMR|7431|002|Tasa|0.000001|0
		CONC|30141514|BOVE-020249|50|H87|PIEZA|BOVEDILÑÓLA TIPO 10 68x122x20, T1 P5|170.83000|8541.5||02
		CIMT|8541.5|002|Tasa|0.160000|1366.64
		CIMR|8541.5|002|Tasa|0.000001|0
		IMPU|0|3375.60
		IMPR|002|0
		IMPT|21097.5|002|Tasa|0.160000|3375.60]]></datos>
        <opciones>PLUGIN_PROCESO:GENERICO_CFDI40:1.0</opciones>
        <opciones>CALCULAR_SELLO</opciones>
      </int:procesarArchivo>
   </soapenv:Body>
</soapenv:Envelope>
									
								

+Response

		
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:procesarArchivoResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
            <servicioTimbrado>
               <id>b5cd1e5a-19a4-47d1-8fd3-2fd744bf9b47</id>
               <timbradoOk>true</timbradoOk>
               <contrato>CONTRATO</contrato>
               <codigo>0</codigo>
               <mensaje>*** generado en modo de pruebas ***</mensaje>
               <version>1.1</version>
               <UUID>UUID</UUID>
               <FechaTimbrado>2022-10-26T17:00:02</FechaTimbrado>
               <selloCFD>SELLO_CFD</selloCFD>
               <noCertificadoSAT>NUMERO_CERTIFICADO</noCertificadoSAT>
               <selloSAT>SELLO_SAT</selloSAT>
               <xmlBase64>PD94bWwgdmVyc2lvbj0m…WVudG8+PC9jZmRpOkNvbXByb2JhbnRlPg==</xmlBase64>
            </servicioTimbrado>]]></return>
      </ns2:procesarArchivoResponse>
   </S:Body>
</S:Envelope>
 					
				

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación y de las cancelaciones. La descripción de los atributos se describe a continuación:

Método consultaCfdiPorUUID

El método permite recuperar el xml en formato base64 de un cfdi.

Parámetros

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario*
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd*
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• uuid*
• UUID del comprobante que se desea recuperar.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
   	<soapenv:Header/>
    	<soapenv:Body>
        <int:consultaCfdiPorUUID>
        <contrato>CONTRATO</contrato>
	<usuario>USUARIO</usuario>
	<passwd>CONTRASEÑA</passwd>
    	<uuid>UUID</uuid>
       </int:consultaCfdiPorUUID>
     </soapenv:Body>
</soapenv:Envelope>
									
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:consultaCfdiPorUUIDResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return>
            <![CDATA[<?xml version="1.0" encoding="UTF-8"?>
            <servicioConsulta>
            <contrato>CONTRATO</contrato>
            <consultaOk>true</consultaOk>
            <codigo>0</codigo>
            <xmlBase64>PD94bWwgWdpdGFsdjExLnhzZCIgeG1sbnM6dGZkPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRm…
            lzY2FsRGlnaXRhbCIvPjwvY2ZkaTpDb21wbGVtZW50bz48L2NmZGk6Q29tcHJvYmFudGU+</xmlBase64>
            </servicioConsulta>]]>
         </return>
      </ns2:consultaCfdiPorUUIDResponse>
   </S:Body>
</S:Envelope>
									
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación, básicamente la respuesta es similar a la del servicio de consulta:

Método acuseCancelacion

El método permite recuperar el acuse de cancelación de un comprobante.

Parámetros

EL contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario*
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd*
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• uuid*
• UUID del comprobante que se desea recuperar.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
   <soapenv:Header/>
   <soapenv:Body>
      <int:acuseCancelacionCfdi>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA</passwd>    
         <uuid>UUID</uuid>
      </int:acuseCancelacionCfdi>
   </soapenv:Body>
</soapenv:Envelope>

									
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:acuseCancelacionCfdiResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return>
         <![CDATA[<?xml version="1.0" encoding="UTF-8"?>
	 <servicioConsulta>
	 <contrato>CONTRATO</contrato>
	 <consultaOk>true</consultaOk>
	 <codigo>0</codigo>
	 <xmlBase64>PD94bWwgdMTlFtR0diTzQ0QMvc…bz48L3BhZ28yMDpQYWdvcz48L2NmZGk6Q29tcGxlbWVudG8+
	 PC9jZmRpOkNvbXByb2JhbnRlPg==</xmlBase64>
	 </servicioConsulta>]]>
	</return>
      </ns2:acuseCancelacionCfdiResponse>
   </S:Body>
</S:Envelope>
									
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación, básicamente la respuesta es similar a la del servicio de consulta:

Método cancelarCfdiConOpciones

Este método crea la solicitud de cancelación de uno o varios CFDI.

Parámetros

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario*
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd*
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• rfcEmisor *
• RFC del emisor al que pertenecen los CFDI que se desea cancelar.
• arregloUUID*
• Arreglo de Strings con el UUID, RFC Receptor y RFC Emisor. A partir del 01 de enero del 2022 será requerido el motivo de cancelación y opcionalmente el folio fiscal que sustituye el UUID que se está cancelando. Esta información separada por el carácter pipe (|):
• UUID para cancelar.
• RFC Receptor del comprobante
• RFC Emisor del comprobante.
• Motivo de cancelación (más adelante se explican los valores que pueden contenerse).
• Folio fiscal que sustituye el documento a cancelar.

Ejemplo: UUID|RFC_Receptor|RFC_Emisor|Total|Motivo|FolioFiscalSustituye

• opciones
• Lista de String con las opciones que serán proporcionadas a la petición en el servicio, las opciones reconocidas son:
• PKCS12
• XML_CANCELACION
• CERT_DEFAULT
• CONSULTAR_SALDO
• Key
• Arreglo de bytes Llave privada correspondiente al certificado.
• keyPass
• Contraseña de la llave privada.
• Cert
• Arreglo de bytes con el archivo del certificado de sello digital. Se debe enviar el archivo binario tal como se obtuvo del SAT (formato CER).

NOTA: Para conocer las guías de llenado de los diferentes tipos de comprobantes puede consultar la información oficial que el SAT ofrece.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
   <soapenv:Header/>
   <soapenv:Body>
      <int:cancelarCfdiConOpciones>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA</passwd>
         <rfcEmisor>RFC_EMISOR</rfcEmisor>        
         <arregloUUID>UUID|RFC_RECEPTOR|RFC_EMISOR|MOTIVO|FolioFiscalSustituye</arregloUUID>       
         <cert>CERTIFICADO</cert>        
         <key>KEY</key>         
         <keyPass>CONTRASEÑA_KEY</keyPass>        
         <opciones>MODO_PRUEBA:2</opciones>
      </int:cancelarCfdiConOpciones>
   </soapenv:Body>
</soapenv:Envelope>
								
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:cancelarCfdiConOpcionesResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return>
            <![CDATA[<?xml version="1.0" encoding="UTF-8"?>
            <servicioCancel>
               <statusOk>true</statusOk>
               <codigo>0</codigo>
               <procesados>1</procesados>
               <cancelados>0</cancelados>
               <cancelaciones>
               <cancelacion>
               <uuid>UUID</uuid>
               <codigo>205</codigo>
               <mensaje>Folio Fiscal No Existente</mensaje>
               </cancelacion>
               </cancelaciones>
               <acuseCancelBase64>PD94bWwgdMTlFtR0diTzQ0Q2Q5b1RvT0MrQ2F3cE9zUXR2enF3R0xRRERmYkp0d0k4dUJFb0NlT2JvN2Mvc
               …bz48L3BhZ28yMDpQYWdvcz48L2NmZGk6Q29tcGxlbWVudG8+PC9jZmRpOkNvbXByb2JhbnRlPg==</acuseCancelBase64>
            </servicioCancel>]]>
         </return>
      </ns2:cancelarCfdiConOpcionesResponse>
   </S:Body>
</S:Envelope>
									
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación y de las cancelaciones. La descripción de los atributos se describe a continuación:

Método obtenerXmlDesdeCsv

El método de obtenerXmlDesdeCsv, devuelve un XML a partir de un CSV con el formato de Prodigia.

Parámetros

EL contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• usuario*
• Indica el usuario con el que se autenticará el servicio de timbrado.
• passwd*
• Indica la contraseña del usuario con el que se autenticará al servicio de timbrado.
• datos (comprobante a convertir ) *
• Formato CSV del archivo que se requiere transformar, el formato para el atributo datos debe estar en texto plano.
• plugin
• Se utiliza para procesar un xml para poder realizar un cfdi con la versión 4.0
• GENERICO_CFDI40:1.0

Ejemplo de petición:

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:int="integracionCfdi.ws.pade.mx">
   <soapenv:Header/>
   <soapenv:Body>
      <int:obtenerXmlDesdeCsv>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA</passwd>
         <datos><![CDATA[CFDI|4.0|S|1|2022-02-18T08:35:11|||||0||XXX||0|P|01||80200|
         EMIS|RFC_EMISOR|NOMBRE_EMISOR|610|
         RECE|RFC_RECEPTOR|NOMBRE_RECEPTOR|38020|||616|CP01
         CONC|84111506||1|ACT||Pago|0|0||01COMP|CRPS20|2.0
         CTOT20|||||||||||3762.03
         CPAG20|2021-09-10T00:00:00|03|MXN|1|3762.03||||||||||
         CPDR20|UUID|||MXN||1|2411.90|2411.90|0.00|01
         CPDR20|UUID|||MXN||1|1350.13|1350.13|0.00|01]]>
         </datos>
         <plugin>GENERICO_CFDI40:1.0</plugin>
      </int:obtenerXmlDesdeCsv>
   </soapenv:Body>
</soapenv:Envelope>

								
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
	<S:Body>
		<ns2:obtenerXmlDesdeCsvResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
		<return><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
		<servicioIntegracion>
		<procesoOk>true</procesoOk>
	 	<contrato>CONTRATO</contrato>
		<codigo>0</codigo>
		<xmlBase64>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iV...L3BhZ28yMDpQYWdvPjwvcGFnbzIwOlBhZ29zPjwvY2ZkaTpDb21wbGVtZW50bz48L2NmZGk6Q29
		tcHJvYmFudGU+
		</xmlBase64>
		</servicioIntegracion>]]></return>
		</ns2:obtenerXmlDesdeCsvResponse>
	</S:Body>
</S:Envelope>
									
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación y de las cancelaciones. La descripción de los atributos se describe a continuación:

Método consultacfdPorUUID

El método permite recuperar el xml en formato base64 de un cfdi, Se encuentra disponible en la siguiente URL: https://timbrado.pade.mx/servicio/rest/consulta/cfdPorUUID

Y cuyos parámetros (URL Query Parameters) se describen a continuación:

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “GET”.
• Las credenciales (usuario y contraseña) deberán ir en el HEADERS de la petición mediante el atributo “Authorization Basic” con el formato usuario:password codificados en Base64.

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Dentro del params se deben especificar los siguientes parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• uuid *
• Indicar UUID del comprobante que se desea recuperar.

Ejemplo de petición mediante Advanced REST Client:

Params

Header

Ejemplo de petición mediante Advanced REST Client:

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:acuseCancelacionCfdiResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
		<servicioConsulta>
		<contrato>CONTRATO</contrato>
		<consultaOk>true</consultaOk>
		<codigo>0</codigo>
		<xmlBase64>PD94bWwgdMTlFtR0diTzQ0QMvc…bz48L3BhZ28yMDpQYWdvcz48L2NmZGk6Q29tcGxlbWVudG8+PC9jZmRpOkNvbXByb2JhbnRlPg==</xmlBase64>
		</servicioConsulta>]]></return>
      </ns2:acuseCancelacionCfdiResponse>
   </S:Body>
</S:Envelope>
								
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación, básicamente la respuesta es similar a la del servicio de timbrado:

Método acuseCancelacion

El método permite recuperar el acuse de cancelación de un comprobante en formato base64, Se encuentra disponible en la siguiente URL: https://timbrado.pade.mx/servicio/rest/integracion/acuseCancelacionCfdi

Y cuyos parámetros (URL Query Parameters) se describen a continuación:

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “GET”.
• Las credenciales (usuario y contraseña) deberán ir en el HEADERS de la petición mediante el atributo “Authorization Basic” con el formato usuario:password codificados en Base64.

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Dentro del params se deben especificar los siguientes parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Indica el código de contrato del usuario con el que se realizará el timbrado.
• uuid *
• Indicar UUID del comprobante que se desea recuperar.

Ejemplo de petición mediante Advanced REST Client:

Params

Header

+Response

									
<?xml version="1.0" encoding="UTF-8"?>
 <servicioCancel>
    <statusOk>true</statusOk>
    <codigo>0</codigo>
    <procesados>0</procesados>
    <cancelados>0</cancelados>
    <cancelaciones>
    <cancelacion>
        <uuid>UUID</uuid>
        <codigo>CODIGO</codigo>
        <mensaje>MENSAJE</mensaje>
    </cancelacion>
    </cancelaciones>
</servicioCancel>
								
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación, básicamente la respuesta es similar a la del servicio de timbrado:

Método cancelarCfdiConOpciones

Este método crea la solicitud de cancelación de uno o varios CFDI, Se encuentra disponible en la siguiente URL: https://timbrado.pade.mx/servicio/rest/integracion/cancelarCfdiConOpciones

Y cuyos parámetros (URL Query Parameters) se describen a continuación:

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “GET”.
• Las credenciales (usuario y contraseña) deberán ir en el HEADERS de la petición mediante el atributo “Authorization Basic” con el formato usuario:password codificados en Base64.

El contrato, usuario y contraseña se asigna una vez adquirido el servicio de timbrado, y se obtienen a través del registro de la plataforma Pade.

Dentro del params se deben especificar los siguientes parámetros

Parámetros marcados con * son obligatorios:

• Contrato *
• Identificador único del contrato de servicios.
• rfcEmisor *
• RFC del emisor al que pertenecen los CFDI que se desea cancelar.
• uuids*
• o Arreglo de Strings con el UUID, RFC Receptor y RFC Emisor. A partir del 01 de enero del 2022 será requerido el motivo de cancelación y opcionalmente el folio fiscal que sustituye el UUID que se está cancelando. Esta información separada por el carácter pipe (|):
• UUID para cancelar.
• RFC Receptor del comprobante.
• RFC Emisor del comprobante.
• Motivo de cancelación (más adelante se explican los valores que pueden contenerse).
• Folio fiscal que sustituye el documento a cancelar.
• UUID para cancelar.

Ejemplo: <arregloUUID>UUID|RFC_Receptor|RFC_Emisor|Total|Motivo|FolioFiscalSustituye</arregloUUID>

• certBase64
• String en base64 con el archivo del certificado de sello digital con que fueron generados los CFDI que se cancelarán.
• keyBase64
• String en base64 con la Llave privada correspondiente al certificado.
• keyPass
• Contraseña de la llave privada que se está enviando.
• Opciones
• Lista de String con las opciones que serán proporcionadas a la petición en el servicio, las opciones reconocidas son:
• PKCS12
• XML_CANCELACION
• CERT_DEFAULT
• CONSULTAR_SALDO

Ejemplo de petición mediante Advanced REST Client:

Params

Header

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:acuseCancelacionCfdiResponse xmlns:ns2="integracionCfdi.ws.pade.mx">
         <return><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
			<servicioConsulta>
			<contrato>CONTRATO</contrato>
			<consultaOk>true</consultaOk>
			<codigo>0</codigo>
			<xmlBase64>PD94bWwgdMTlFtR0diTzQ0QMvc…bz48L3BhZ28yMDpQYWdvcz48L2NmZGk6Q29tcGxlbWVudG8+PC9jZmRpOkNvbXByb2JhbnRlPg==</xmlBase64>
			</servicioConsulta>]]></return>
      </ns2:acuseCancelacionCfdiResponse>
   </S:Body>
</S:Envelope>
								
								

Nota: No todos los atributos están presentes en la respuesta, y esto dependerá del resultado de la operación. La descripción de los atributos se describe a continuación, básicamente la respuesta es similar a la del servicio de timbrado:

Opciones del servicio de Cancelación

	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>0</cancelados>
	<cancelaciones>
	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>94</codigo>
	<mensaje>No Cancelable</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

											
	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>1</cancelados>
	<cancelaciones>
	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>96</codigo>
	<mensaje>En proceso</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

											
	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>1</cancelados>
	<cancelaciones>
 	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>201</codigo>
	<mensaje>Cancelado sin aceptación</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

											
	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>0</cancelados>
	<cancelaciones>
	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>202</codigo>
	<mensaje>Previamente cancelado</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

											
	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>0</cancelados>
	<cancelaciones>
	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>203</codigo>
	<mensaje>Rfc no corresponde</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

											
	<servicioCancel>
	<statusOk>true</statusOk>
	<rfc>RFC</rfc>
	<codigo>0</codigo>
	<mensaje>Mensaje genérico de manera general</mensaje>
	<procesados>1</procesados>
	<cancelados>0</cancelados>
	<cancelaciones>
	<cancelacion>
	<uuid>UUID</uuid>
	<codigo>205</codigo>
	<mensaje>Uuid no existe</mensaje>
	</cancelacion>
	</cancelaciones>
	<acuseCancelBase64/>
	</servicioCancel>
											
										

Códigos

Códigos de respuesta para los diferentes servicios

Códigos para los nuevos estatus de cancelación

Códigos para el nodo estatusCfdi en el método de consulta estatus de comprobantes