Retenciones
Guía de Implementación de WEB SERVICE para Cancelación de Retenciones.
Pruebas
URL
Para realizar una prueba se debe realizar una petición de tipo POST
a la siguiente URL.
https://test.paxfacturacion.com.mx:458/webservices/wcfCancelaasmx.asmx
Producción
URL
Para realizar una prueba se debe realizar una petición de tipo POST
a la siguiente URL.
https://www.paxfacturacion.com.mx:458/WebServices/wcfCancelaASMX.asmx
Debemos de tomar como referencia de ejemplo el siguiente código si se envía un XML:
wcfCancela servicioXML = new wcfCancela ();
string resultado = servicioXML.fnCancelaXML20(sListaUUID, psRFC, pnId_Estructura, sMotivosCancelacion, sFoliosSustitucion, sNombre, sContraseña);
Atributo | Descripción |
---|---|
sListaUUID |
Lista de UUID’s a Cancelar |
psRFC |
RFC Emisor que solicita la Cancelación |
sMotivosCancelacion |
Lista de Motivos Cancelación de cada UUID de la Lista |
sFoliosSustitucion |
Lista de Folios Sustitución de cada UUID de la Lista |
sNombre |
Usuario para autenticar el servicio |
sContrasena |
Contraseña para autenticar el servicio |
Método de uso
Es necesario agregar las siguientes referencias a cada uno de sus sistemas, he instanciar un servicio como el siguiente:
wcfRecepcion servicioXML = new wcfRecepcion();
string resultado = servicioXML.fnEnviarXML20([e50160ed-a2cb-4fce-b687-b71f30870d95], " DCO020624P10", 0,[01,02,03,04], [f60160ed-a2cb-4fce-b687-b71f30870d95], "usuario", "password64");
En donde:
Atributo | Descripción |
---|---|
ListaUUID |
[e50160ed-a2cb-4fce-b687-b71f30870d95] |
RFC |
EWE1709045U0 |
Estructura |
0 |
Motivo Cancelacion |
01,02,03,04 |
Folio Sustitucion |
[f60160ed-a2cb-4fce-b687-b71f30870d95] |
Usuario |
nombre_usuario |
Contraseña |
password64 (Proporcionada por PAX) |
Enviar petición
En el siguiente ejemplo se muestra cómo enviar la solicitud y la respuesta proporcionada por el servicio web.
Petición
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:test="https://test.paxfacturacion.com.mx:458">
<soapenv:Header />
<soapenv:Body>
<test: fnCancelarXML20>
<test:sListaUUID>
<test:string>e60160ed-a2cb-4fce-b687-b71f30870d95</test:string>
</test:sListaUUID>
<test:psRFC> DCO020624P10</test:psRFC>
<test:pnId_Estructura>0</test:pnId_Estructura>
<test:sMotivosCancelacion>
<test:string>01</test:string>
</test:sMotivosCancelacion>
<test:sFoliosSustitucion>
<test:string>f60160ed-a2cb-4fce-b687-b71f30870d95</test:string>
</test:sFoliosSustitucion>
<test:sNombre>ws_retenciones</test:sNombre>
<test:sContraseña>
wrfCv8SVxITEscO8w43DhsSCxLBZcsKbwr/Em8OtwoJNwqTDo++9uO+/oO+/pREB77+Z776J772l</test:sContraseña>
</test: fnCancelarXML20>
</soapenv:Body>
</soapenv:Envelope>
Respuesta
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<fnCancelarXMLResponse xmlns="https://test.paxfacturacion.com.mx:458">
<fnCancelarXMLResult><![CDATA[<Cancelacion xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" RfcEmisor="DCO020624P10" Fecha="2015-01-21T16:56:14" xmlns="http://cancelaretencion.sat.gob.mx"><Folios><UUID>e60160ed-a2cb-4fce-b687-b71f30870d95 </UUID><UUIDEstatus>1201 </UUIDEstatus><UUIDdescripcion>1201 - UUID Cancelado. </UUIDdescripcion><UUIDfecha>2015-01-21T16:56:14 </UUIDfecha></Folios><Signature></Signature></Cancelacion>]></fnCancelarXMLResult>
</fnCancelarXMLResponse>
</soap:Body>
</soap:Envelope>
Credenciales
Usuario:
ws_retenciones
Contraseña:
wrfCv8SVxITEscO8w43DhsSCxLBZcsKbwr/Em8OtwoJNwqTDo++9uO+/oO+/pREB77+Z776J772l
Para fines de este documento de integración se uso el certificado emisor (SHA256)
para generar la firma de cancelación, este certificado tiene asignado el RFC de pruebas EWE1709045U0
.
Descargar llave
Códigos de error
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 |
---|---|
1201 |
Comprobante Cancelado Satisfactoriamente. |
1202 |
Comprobante previamente cancelado. |
1203 |
UUID no corresponde con el emisor. |
1205 |
Comprobante no encontrado. |
1301 |
XML mal formado. |
1302 |
Estructura de folios no válida. |
1303 |
Estructura de RFC no válida. |
1304 |
Estructura de fecha no válida. |
1305 |
Certificado no corresponde al emisor. |
1306 |
Certificado no vigente. |
1307 |
Uso de FIEL no permitido. |
1308 |
Certificado revocado o caduco. |
1309 |
Firma mal formada o inválida. |
96 |
Usuario o contraseña incorrecta. |
97 |
No hay créditos disponibles. |
El costo del Servicio es de 1 Créditos por petición.