Propósito:
Este servicio web permite extraer la constancia de situación fiscal y la opinión de cumplimiento del SAT en formato PDF para todas sus empresas registradas en bFiskur. Es un servicio con costo extra.
Punto Final (Endpoint):
https://bfiskurapp.bitam.com/robots/bFiskurDwnXMLWS/descargasSAT_WS.php
Parámetros Requeridos:
El Web Service aceptará las siguientes peticiones HTTP GET con los siguientes parámetros:
- Grupo:Obligatorio. En este caso se usará su identificador de cliente asignado en bFiskur, por ejemplo: “CONSORCIOMINERO”.
- Periodo:Obligatorio. Periodo fiscal para el cual se requiere descargar los documentos en formato AÑO-MES, ejemplo: 2024-01
- Apikey: La llave de acceso expedida por bFiskur. Ejemplo:
- 7a3b1c9d-ef01-2g3h-4i5j-klm6nopqrstuvwxyz (llave invalida con propósito ilustrativo)
Nota: Todos los parámetros marcados con asterisco (*) son obligatorios.
Respuesta del Web Service
La respuesta del Web Service es en formato ZIP y contiene todos los documentos existentes para sus empresas registradas en bFiskur en el periodo solicitado.
- Constancia de Situación Fiscal
- Opinión de cumplimiento SAT
El zip debe de contener un folder para cada RFC y dentro del folder respectivo deberán venir los documentos en que correspondan a la empresa
Formato de Respuesta
El Webservice responde con un archivo en formato ZIP conteniendo los documentos solicitados que se encuentren en bFiskur
Ejemplos del llamado al WebService
NOTA: El nombre de CONSORCIOMINERO aquí usado y la API KEY son invalidos y ficticios, se muestran solo con propósitos ilustrativos.
Extrae todos las constancias de situación fiscal y la opinión de cumplimiento del SAT en formato PDF para todas las empresas registradas en bFiskur para el grupo CONSORCIOMINERO
Consideraciones Adicionales:
- Manejo de Errores: En caso de omitir un parámetro obligatorio o usar un valor inadecuado el servicio contestara con un “error”:”resource not found”
- Limitación de Tasa: El máximo número de días que se pueden extraer es: 1 mes.
- Seguridad: Se utiliza el protocolo HTTPS durante la transmisión. El resultado devuelto no lleva encriptación adicional.
- Pruebas: Para probar el servicio puede usarse Postman.