Versión 1.0
Esta guía muestra los pasos mínimos necesarios para comenzar a utilizar AppDTE Community y emitir el primer Documento Tributario Electrónico (DTE).
Se asume que AppDTE Community ya se encuentra instalada y configurada correctamente.
Antes de comenzar verifique que:
AppDTE Community se encuentra ejecutándose. La base de datos fue creada correctamente. Existe un certificado digital instalado. Se encuentran cargados los CAF correspondientes. El servicio responde mediante HTTP.
Todas las solicitudes protegidas requieren autenticación.
Solicite un token utilizando el endpoint de autenticación.
POST /login
Ejemplo:
{ “username”:“demo”, “password”:“demo” }
La respuesta contendrá el token de acceso.
Después del primer inicio de sesión se recomienda cambiar la contraseña del usuario administrador.
Las credenciales iniciales son únicamente para la instalación.
Construya el JSON correspondiente al DTE que desea emitir.
El formato completo se encuentra documentado en la referencia de la API.
Enviar el documento mediante:
POST /sendDTE
Incluyendo:
Token de autenticación. JSON del documento.
Si el envío es exitoso la API devolverá la información correspondiente al DTE emitido.
Dependiendo del tipo de documento podrá obtener:
Folio. Track ID. Estado. XML generado. PDF (si corresponde).
Para recuperar posteriormente un documento emitido utilice:
POST /getDTE
Una vez validado el funcionamiento básico de la API se recomienda revisar: