Otros sistemas (un software contable, una tienda, un programa a medida) pueden usar Axentra directamente, sin pasar por la pantalla. Lo hacen con un token de API: una clave que usted crea desde su perfil y que identifica al otro sistema como si fuera usted.
Un token sirve, por ejemplo, para que un sistema externo emita comprobantes fiscales electrónicos (e-CF) a través del módulo de Facturación Electrónica de Axentra y consulte su estado ante la DGII.
Un token tiene exactamente sus mismos permisos. Lo que usted puede hacer en la aplicación, el token lo puede hacer por API, y lo que a usted no le está permitido, al token tampoco. No hay permisos separados para tokens.
Eso tiene dos consecuencias que conviene tener presentes:
Un token no puede crear ni revocar tokens. Esas dos acciones solo se hacen desde la aplicación, con su sesión normal. Así, un token que se filtre no puede fabricar otros ni silenciar los demás.
Se abre una ventana con el token completo. Cópielo en ese momento. Por seguridad, Axentra no guarda el token y no lo puede volver a mostrar. Si lo pierde, revóquelo y cree otro.
En la lista solo se ve el comienzo del token, para distinguir uno de otro.
El otro sistema envía el token en cada llamada, en la cabecera HTTP X-Axentra-Token, a la dirección de la API de su empresa:
https://<su-empresa>.axentra.com.do/graphql
donde <su-empresa> es la misma dirección con la que entra a Axentra. La API es GraphQL: se envía una petición POST con un cuerpo JSON que contiene la consulta.
Un ejemplo mínimo, con curl, que pide los datos del usuario al que pertenece el token:
curl https://<su-empresa>.axentra.com.do/graphql \
-H "Content-Type: application/json" \
-H "X-Axentra-Token: axt_..." \
-d '{"query":"{ me { email fullName } }"}'
Una llamada que lleva a la vez el token y una sesión de la aplicación se rechaza: cada llamada usa una sola credencial.
La operación createECFDocument crea un comprobante a partir de los datos del documento (tipo, comprador, líneas) y lo firma y envía a la DGII. Si la empresa tiene configuradas las cuentas contables por defecto (cuentas por cobrar, ingresos e ITBIS por pagar), también registra el asiento contable del comprobante; no crea una factura de cliente ni mueve inventario. Requiere que la cuenta tenga permiso para crear comprobantes y que la Facturación Electrónica esté habilitada en la empresa. Los campos disponibles son los mismos que ve en el formulario de emisión manual de la aplicación.
mutation {
createECFDocument(input: {
documentType: E32
razonSocialComprador: "Consumidor final"
items: [
{ nombreItem: "Servicio de consultoría", cantidadItem: "1", precioUnitarioItem: "1500.00", itbisRate: "18" }
]
}) {
id
ncf
status
}
}
query {
ecfDocument(id: "<id del comprobante>") {
ncf
status
trackingID
dgiiResponse
}
}
Tenga en cuenta que si su empresa está en el ambiente de certificación de la DGII, los comprobantes emitidos por API van al mismo ambiente, igual que los emitidos desde la pantalla.
Cada empresa tiene un explorador interactivo de la API (GraphiQL) en:
https://<su-empresa>.axentra.com.do/graphql/ide
Ahí puede escribir consultas con autocompletado y leer la documentación de cada operación en el panel de la izquierda. Para que las consultas se ejecuten con su identidad, abra la pestaña Headers en la parte inferior y pegue su token:
{ "X-Axentra-Token": "axt_..." }
Sin cabecera, el explorador solo permite leer la estructura de la API; cualquier consulta de datos responde que no está autenticado.
En la tarjeta Tokens de API, pulse Revocar junto al token y confirme. El token deja de funcionar de inmediato. El registro se queda en la lista marcado como Revocado, con la fecha, para que tenga el historial.
Revoque un token cuando:
429 y debe reintentar un momento después.401 y no se reactiva: cree uno nuevo.