Este checklist tiene como objetivo asegurarte de que tu implementación de la API de Syncfy Stamping para el timbrado de facturas esté completa y cumpla con las mejores prácticas. Esto ayudará a prevenir errores en tu integración.
1. Manejo de usuarios
Es fundamental verificar que se realice correctamente el manejo de usuarios en la integración:
Crear un usuario por cada entidad, cliente o contribuyente, según sea el caso.
Utilizar un identificador que relacione al usuario de Syncfy con el usuario de tu sistema a través del id_external.
Almacenar el identificador “id_user” asignado por Syncfy.
2. Manejo de errores
Asegúrate de que la integración esté preparada para gestionar errores de manera eficiente:
Almacenar el rid de los errores presentados, lo que facilita el seguimiento de los problemas.
Procesar los campos “errors” y “message” para mostrar los errores de manera adecuada.
3. Integración
Verifica que la integración cumpla con las normas del SAT para el llenado de CFDIs según los tipos que se vayan a soportar:
Seguir las reglas del SAT para el llenado de CFDIs, ya que Syncfy se apega a estas normativas.
Asegurarte de que los códigos utilizados en el llenado del CFDI correspondan a los catálogos proporcionados por el SAT.
4. Seguridad
Es crucial garantizar que la implementación no tenga vulnerabilidades:
La API Key no debe estar expuesta ni visible en el código.
La API Key no debe enviarse como parámetro en la URL de las peticiones.
Utilizar el token de sesión para autenticar las solicitudes del navegador, en lugar de la API Key.
5 Documentación y pruebas
Asegúrate de que la documentación de la implementación y las pruebas estén adecuadamente gestionadas:
Documentar todos los endpoints utilizados y su configuración específica.
Garantizar que el equipo de desarrollo tenga acceso a la documentación de la API de Syncfy.
Realizar pruebas unitarias y de integración para cada funcionalidad implementada.