Ambiente de producción: este ambiente se utiliza para realizar los procesos de registrar, asignar timbres y consultar estatus de los asociados. La url de este ambiente varia según el tipo de conexión al servicio que se vaya a utilizar (SOAP o REST). Todas nuestras url de este ambiente inician con https://timbrado.pade.mx
Ejemplo: https://timbrado.pade.mx/servicio/distribuidores?WSDL

Los protocolos manejados son SOAP y REST

Método registrarAsociado

Este método permite realizar un registro o alta de un asociado por medio de su rfc.

Parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Número de contrato del asociado padre. Debe corresponder con el servicio al que se registrará el asociado.
• usuario *
• Usuario del asociado padre.
• passwd *
• Contraseña del asociado padre.
• rfc *
• RFC con el que se dará de alta en el sistema al asociado hijo.
• nombre *
• Razón social del asociado hijo con la cual se dará de alta en el sistema.
• email *
• Correo electrónico con el cual se dará de alta al asociado hijo.
• servicio *
• Tipo de servicio con el que se dará de alta al nuevo asociado.
• Valores permitidos: TIMBRADO, RECEPCION, EMISION, DESCARGA_MASIVA
• tipo
• Tipo de usuario que requiere para el asociado.
• Ejemplos: USUARIO, DISTRIBUIDOR.
• Encaso de no ingresar información, el valor predeterminado es USUARIO
• esHijo
• Parametro que sirve para dar de alta un usuario que le pertenezca al padre.
• Ejemplos: true, false.
• En caso de no ingresar información, el valor predeterminado es false.

+Request

									
	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:dis=
	"http://distribuidores.ws.pade.prodigia.mx/">
		<soapenv:Header/>
 		<soapenv:Body>
 			<dis:registrarAsociado>
				<contrato>CONTRATO</contrato>
				<usuario>USUARIO</usuario>
				<passwd>PASSWORD</passwd>
				<nombre>RAZON_SOCIAL</nombre>
				<rfc>RFC</rfc>
				<email>EMAIL</email>
				<servicio>TIMBRADO</servicio>
				<!--Optional:-->
				<tipo>USUARIO</tipo>
				<!--Optional:-->
 				<esHijo>true</esHijo>

 				</dis:registrarAsociado>
 		</soapenv:Body>
 	</soapenv:Envelope>
									
								

+Response

									
	<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 		<S:Body>
			<ns2:consultarEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
 			<return><![CDATA[<ResultDistribuidores>
 			<codigoAsoc>CODIGO CLIENTE</codigoAsoc>
 			<codigo>0</codigo>
 			<contrato>CONTRATO ASOCIADO</contrato>
 			<mensaje>Se ha registrado al asociado con éxito</mensaje>
 			<passwd>CONTRASEÑA</passwd>
 			<rfc>RFC</rfc>
 			<usr>EMAIL ASOCIADO </usr>
 			</ResultDistribuidores>]]></return>
 			</ns2:consultarEstatusResponse>
 		</S:Body>
 	</S:Envelope>
									
								

Método restablecerPassword

Este método permite restablecer la contraseña de un usuario.

Parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Número de contrato del asociado padre.
• usuario *
• Usuario del asociado padre.
• passwd *
• Contraseña del asociado padre.
• codigoCliente *
• Código del asociado al que se le va a cambiar la contraseña.
• usrCliente *
• Usuario del código de cliente al cual se se solicita el cambio de la contraseña.
• nuevoPasswd *
• Nueva contraseña que se le va asignar al usuario.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dis="http://distribuidores.ws.pade.prodigia.mx/">
   <soapenv:Header/>
   <soapenv:Body>
      <dis:restablecerPassword>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA$</passwd>
         <codigoCliente>CODIGO  CLIENTE</codigoCliente>
         
         <usrCliente>USUARIO </usrCliente>>
         <nuevoPasswd>NUEVA CONTRASEÑA</nuevoPasswd>
      </dis:restablecerPassword>
   </soapenv:Body>
   </soapenv:Envelope>
									
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:restablecerPasswordResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
         <return><![CDATA[<ResultCambiarPasswd>
    		<cambioOk>false</cambioOk>
   		<codigo>0</codigo>
    		<mensaje>Password cambiado satisfactoriamente</mensaje>
	  </ResultCambiarPasswd>]]></return>
    </ns2:restablecerPasswordResponse>
   </S:Body>
</S:Envelope>

									
								

Método asignarTransacciones

Este método permite la asignación o recuperación de timbres a un asociado, en el caso de querer recuperar timbres, basta con indicar la cantidad en negativo.

Parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Número de contrato del asociado padre.
• usuario *
• Usuario del asociado padre.
• passwd *
• Contraseña del asociado padre.
• rfc *
• RFC del asociado hijo al que se le quiere asignar o recuperar timbres.
• transacciones *
• Cantidad de timbres a asignar o recuperar.
• Ejemplos: 10000,-4000.
• contratoAsoc
• Número de contrato del asociado hijo al cual se le quiere asignar o recuperar timbres, esto en caso de que el asociado hijo cuente con más de un contrato.

+Request

										
 	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 	xmlns:dis="http://distribuidores.ws.pade.prodigia.mx/">
 		<soapenv:Header/>
 		<soapenv:Body>
			 <dis:asignarTransacciones>
				 <contrato>CONTRATO</contrato>
				 <usuario>USUARIO</usuario>
				 <passwd>PASSWORD</passwd>
 				 <rfc>RFC</rfc>
 				 <transacciones>1000</transacciones>
 				 <contratoAsoc>CONTRATO_HIJO</contratoAsoc>
 			</dis:asignarTransacciones>
 		</soapenv:Body>
 	</soapenv:Envelope>
									
								

+Response

									
 	<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 		<S:Body>
 			<ns2:consultarEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
 				<return><![CDATA[<ResultDistribuidores>
 				<codigo>0</codigo>
 				<mensaje>Se asignaron las transacciones éxitosamente</mensaje>
 				<rfc>RFC</rfc>
 				<saldoAnterior>0</saldoAnterior>
 				<saldoNuevo>1000</saldoNuevo>
 				</ResultDistribuidores>]]></return>
 			</ns2:consultarEstatusResponse>
 		</S:Body>
 	</S:Envelope>
									
								

Método consultarAsociadoEstatus

Este método permite visualizar los asociados hijos que se tienen registrados.

Parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Número de contrato del asociado padre.
• usuario *
• Usuario del asociado padre.
• passwd *
• Contraseña del asociado padre.
• rfc
• RFC con el que se dio de alta en el sistema al asociado hijo.
• contratoAsoc
• Número de contrato del asociado que se requiere consultar el estatus.

+Request

									
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dis="http://distribuidores.ws.pade.prodigia.mx/">
   <soapenv:Header/>
   <soapenv:Body>
      <dis:consultarAsociadoEstatus>
         <contrato>CONTRATO</contrato>
         <usuario>USUARIO</usuario>
         <passwd>CONTRASEÑA</passwd>
         <!--Optional:-->
         <rfc>RFC ASOCIADO HIJO</rfc>
         <!--Optional:-->
         <contratoAsoc>CONTRATO ASOCIADO HIJO</contratoAsoc>
      </dis:consultarAsociadoEstatus>
   </soapenv:Body>
</soapenv:Envelope>
									
								

+Response

									
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:consultarAsociadoEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
         <return><![CDATA[<ResultObtEstatus>
    <estatusOk>true</estatusOk>
    <resultAsociadosEsHijo>
        <codigo>0</codigo>
        <contrato>
            <activo>Activo</activo>
            <codigo>CONTRATO ASOCIADO HIJO</codigo>
            <transDisponibles>#</transDisponibles>
            <transRealizadas>#</transRealizadas>
            <transTotales>#</transTotales>
        </contrato>
        <razonSocial>RAZON SOCIAL</razonSocial>
        <rfc>RFC</rfc>
        <tipo>TIPO DE USUSARIO</tipo>
    </resultAsociadosEsHijo>
    <resultAsociadosEsHijo>
        <codigo>0</codigo>
        <contrato>
            <activo>Activo</activo>
            <codigo>CONTRATO ASOCIADO HIJO</codigo>
            <transDisponibles>#</transDisponibles>
            <transRealizadas>#</transRealizadas>
            <transTotales>#</transTotales>
        </contrato>
        <razonSocial>RAZON SOCIAL</razonSocial>
        <rfc>RFC</rfc>
        <tipo>TIPO DE USUSARIO</tipo>
    </resultAsociadosEsHijo>
</ResultObtEstatus>]]></return>
      </ns2:consultarAsociadoEstatusResponse>
   </S:Body>
</S:Envelope> 


									
								

Método Registrar asociado

Este método permite realizar un registro o alta de un asociado por medio de su rfc en la siguiente URL https://timbrado.pade.mx/servicio/rest/distribuidores/registrarAsociado

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “POST” y contener al menos el parámetro “contrato” con el código de contrato del usuario como “Query Parameter”.
• También pueden ser especificadas como “Query Parameters” las opciones de timbrado que se detallan en la sección “Opciones del Servicio” (de manera opcional).
• 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 tipo de contenido (atributo Content-Type) para Registrar asociado será “application/json”.
• El XML deberá enviarse en el “Body” de la petición.

Dentro del body se deben especificar los siguientes parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Númerodecontrato del asociado padre. Debe corresponder con el servicio al que se registrará el asociado.
• rfc *
• RFC con el que se dará de alta en el sistema al asociado hijo.
• nombre *
• Razónsocial del asociado hijo con la cual se dará de alta en el sistema.
• email *
• Correo electrónico con el cual se dará de alta al asociado hijo.
• servicio *
• Tipodeservicio con el que se dará de alta al nuevo asociado.
• Valores permitidos: TIMBRADO, RECEPCION, EMISION, DESCARGA_MASIVA
• tipo
• Tipodeusuario que requiere para el asociado.
• Ejemplos: USUARIO, DISTRIBUIDOR.
• Encasodenoingresar información, el valor predeterminado es USUARIO

Body:

Header:

+Response

									
	<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 		<S:Body>
			<ns2:consultarEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
 			<return><![CDATA[<ResultDistribuidores>
 			<codigo>0</codigo>
 			<mensaje>Se ha registrado al asociado con éxito</mensaje>
 			<rfc>RFC</rfc>
 			</ResultDistribuidores>]]></return>
 			</ns2:consultarEstatusResponse>
 		</S:Body>
 	</S:Envelope>
									
								

Método Asignar/recuperar timbres

Este método permite la asignación o recuperación de timbres a un asociado, en el caso de querer recuperar timbres, basta con indicar la cantidad en negativo.
URL: https://timbrado.pade.mx/servicio/rest/distribuidores/asignarTransacciones

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “POST” y contener al menos el parámetro “contrato” con el código de contrato del usuario como “Query Parameter”.
• También pueden ser especificadas como “Query Parameters” las opciones de timbrado que se detallan en la sección “Opciones del Servicio” (de manera opcional).
• 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 tipo de contenido (atributo Content-Type) para Asignar o Recuperar transacciones será “application/json”.
• El XML deberá enviarse en el “Body” de la petición.

Dentro del body se deben especificar los siguientes parámetros

Parámetros marcados con * son obligatorios:

• contrato *
• Número de contrato del asociado padre.
• rfc *
• RFC al que se le asignara o recuperara transacciones.
• transacciones *
• Cantidad de transacciones a asignar, puede colocar en negativo el número en caso de querer recuperar.
• contratoAsoc *
• Número de contrato del asociado hijo al cual se le quiere asignar o recuperar timbres, esto en caso de que el asociado hijo cuente con más de un contrato.

Body:

Header:

+Response

									
 	<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 		<S:Body>
 			<ns2:consultarEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
 				<return><![CDATA[<ResultDistribuidores>
 				<codigo>0</codigo>
 				<mensaje>Se asignaron las transacciones éxitosamente</mensaje>
 				<rfc>RFC</rfc>
 				<saldoAnterior>0</saldoAnterior>
 				<saldoNuevo>1000</saldoNuevo>
 				</ResultDistribuidores>]]></return>
 			</ns2:consultarEstatusResponse>
 		</S:Body>
 	</S:Envelope>
									
								

Método Consultar estatus

Este método permite conocer el estatus actual del asociado, su cantidad actual de timbres totales, realizados y disponibles, además del tipo de asociado.
URL: https://timbrado.pade.mx/servicio/rest/distribuidores/consultarEstatus

Parámetros

• El urlquery de la petición en REST deberá ser del tipo “POST” y contener al menos el parámetro “contrato” con el código de contrato del usuario como “Query Parameter”.
• También pueden ser especificadas como “Query Parameters” las opciones de timbrado que se detallan en la sección “Opciones del Servicio” (de manera opcional).
• 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 tipo de contenido (atributo Content-Type) para consulrar estatus será “application/json”.
• El XML deberá enviarse en el “Body” de la petición.

Parámetros:
El tipo de contenido (atributo Content-Type) deberá especificar el valor “application/json“.

• contrato: Número de contrato del asociado.
• rfc: RFC con el que se dará de alta en el sistema al asociado hijo.
• contratoAsoc: Numero de contrato del asociado hijo del cual se requiere consultar su estatus.

Body:

Header:

+Response

									
 	
 <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 		<S:Body>
 			<ns2:consultarEstatusResponse xmlns:ns2="http://distribuidores.ws.pade.prodigia.mx/">
 				<return><![CDATA[<ResultDistribuidores>
				 <codigo>0</codigo>
				 <disponibles>1000</disponibles>
				 <estatus>Activo</estatus>
				 <realizadas>0</realizadas>
				 <rfc>RFC</rfc>
				 <tipo>Usuario</tipo>
				 <totales>1000</totales>
				 </ResultDistribuidores>]]></return>
 			</ns2:consultarEstatusResponse>
 		</S:Body>
</S:Envelope>