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.