Herramientas de usuario
web-service-retenciones
Diferencias
Muestra las diferencias entre dos versiones de la página.
| Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
|
web-service-retenciones [2015/01/25 03:33] |
web-service-retenciones [2016/01/05 23:15] (actual) |
||
|---|---|---|---|
| Línea 189: | Línea 189: | ||
| | pfx_pass |Llave publica usada para abrir el PFX. | | | pfx_pass |Llave publica usada para abrir el PFX. | | ||
| | pfx_pem |Archivo resultante de convertir el certificado (.cer) y la llave (.key) a PEM. Para generar este archivo puede consultar el documento “Manual de Generación del PFX” ofrecido por iTimbre. | | | pfx_pem |Archivo resultante de convertir el certificado (.cer) y la llave (.key) a PEM. Para generar este archivo puede consultar el documento “Manual de Generación del PFX” ofrecido por iTimbre. | | ||
| - | | folio_seguimiento |Parámetro de retenciones y pagos, este parámetro se envia cuando se desea recuperar un acuse de cancelación brindando un folio de seguimiento.. | | + | |
| ==== Ejemplos Cancelación ==== | ==== Ejemplos Cancelación ==== | ||
| Línea 212: | Línea 212: | ||
| </file> | </file> | ||
| - | **Ejemplo de codificación de llamado en formato JSON para recuperar acuse de cancelación de retenciones y pagos**: | ||
| - | <file JSON llamada-0001cancelacion.json> | ||
| - | { | ||
| - | "id":1001, | ||
| - | "method":"verificarEstatusRetencion", | ||
| - | "params": { | ||
| - | "user":"miemail@midominio.com", | ||
| - | "pass":"cabb17fb8536180e11af6dff0da42132", | ||
| - | "RFC":"EEM010101XYZ", | ||
| - | "folio_seguimiento":"005", | ||
| - | |||
| - | } | ||
| - | } | ||
| - | </file> | ||
| ==== Respuesta ==== | ==== Respuesta ==== | ||
| Línea 240: | Línea 226: | ||
| | folio_seguimiento |Parámetro de retenciones y pagos, este parametro se regresa cuando se activa la cancelación asincrona brindando un folio de seguimiento. | | | folio_seguimiento |Parámetro de retenciones y pagos, este parametro se regresa cuando se activa la cancelación asincrona brindando un folio de seguimiento. | | ||
| - | Ejemplo del manejo de los folios: | ||
| - | <code PHP> | ||
| - | $primer_folio = $folios[0] -> UUID; | ||
| - | $estatus_primer_folio = $folios[0] -> status; | ||
| - | $segundo_folio = $folios[1] -> UUID; | ||
| - | $estatus_segundo_folio = $folios[1] -> status; | ||
| - | </code> | ||
| **Ejemplo de respuesta válida arrojada por el Web Service para retenciones y pagos (un folio)**: | **Ejemplo de respuesta válida arrojada por el Web Service para retenciones y pagos (un folio)**: | ||
| Línea 272: | Línea 251: | ||
| </file> | </file> | ||
| - | === Códigos de Respuesta de Estatus UUID ( Para retenciones y pagos) === | + | === Códigos de Respuesta de Estatus UUID === |
| ^ Código ^ Validación | | ^ Código ^ Validación | | ||
| Línea 280: | Línea 259: | ||
| | 1205 |UUID no existe. | | | 1205 |UUID no existe. | | ||
| - | === Códigos de Respuesta a nivel petición (Para retenciones y pagos) === | + | === Códigos de Respuesta a nivel petición === |
| ^ Código ^ Validación | | ^ Código ^ Validación | | ||
| Línea 296: | Línea 275: | ||
| \\ | \\ | ||
| + | ====Método para Consulta de estatus de cancelación==== | ||
| + | |||
| + | Al intentar efectuar una cancelación entre 2 y 10,000 folios como respuesta se recibirá un folio de seguimiento, como se explico anteriormente. Para finalmente recibir un acuse es necesario conectarse nuevamente pero ahora llamando al método **verificarEstatusRetencion**.El único parámetro que deben mandar es 'folio_seguimiento'. La respuesta es idéntica a la de la cancelación solo que aquí nunca recibirían el retcode 2. | ||
| + | |||
| + | ^ PARÁMETRO ^ DESCRIPCIÓN | | ||
| + | | id |Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. | | ||
| + | | method |El nombre del método para cancelar : **verificarEstatusRetencion**. | | ||
| + | | params |Debe contener un arreglo con los parámetros: user, pass, RFC, y folio de seguimiento. | | ||
| + | | user |Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). | | ||
| + | | pass |Contraseña generada por iTimbre al momento de registrar al emisor. | | ||
| + | | RFC |RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. | | ||
| + | | folio_seguimiento |Parámetro de retenciones y pagos, este parámetro se envia cuando se desea recuperar un acuse de cancelación brindando un folio de seguimiento.. | | ||
| + | |||
| + | |||
| + | **Ejemplo de codificación de llamado en formato JSON para recuperar acuse de cancelación de retenciones y pagos**: | ||
| + | |||
| + | <file JSON llamada-0001cancelacion.json> | ||
| + | { | ||
| + | "id":1001, | ||
| + | "method":"verificarEstatusRetencion", | ||
| + | "params": { | ||
| + | "user":"miemail@midominio.com", | ||
| + | "pass":"cabb17fb8536180e11af6dff0da42132", | ||
| + | "RFC":"EEM010101XYZ", | ||
| + | "folio_seguimiento":"005", | ||
| + | |||
| + | } | ||
| + | } | ||
| + | </file> | ||
web-service-retenciones.1422156788.txt.gz · Última modificación: 2016/01/05 23:15 (editor externo)
Herramientas de la página
