Abra su cuenta API

Qué es una cuenta APICopiar enlace a esta sección

Una cuenta API sirve para que su sistema (su tienda, su ERP o su plataforma) timbre facturas por su cuenta, sin abrir Fiscalisto. Va aparte de sus empresas: entra con el mismo correo y contraseña, pero tiene su propio equipo, sus propios emisores y sus propios timbres. Puede facturar con varios RFC desde la misma cuenta.

Paso a pasoCopiar enlace a esta sección

1. Abra el selector de empresa (arriba a la izquierda) y elija Nueva cuenta API.
2. Escriba un Nombre para reconocerla, por ejemplo el de su plataforma, y pulse Crear cuenta API.
3. Aparece Su cuenta API está lista con su llave de pruebas (empieza con fk_test_). Cópiela y guárdela en su servidor: no la volvemos a mostrar. Pulse Ir a Desarrolladores.
4. En Inicio, copie el ejemplo de Su primera factura (curl o JavaScript), ponga su llave y ejecútelo. La respuesta trae la factura timbrada.
5. Siga la lista Para facturar en producción: timbre una factura de prueba, agregue su emisor, tenga timbres, cree su llave de producción y reciba los eventos de producción en Webhooks.

Cuando ya timbró en pruebas aparece Revisión de su integración: con sus solicitudes de pruebas de los últimos 7 días dice si timbra con Idempotency-Key, si ya probó un rechazo del SAT, si su endpoint de webhooks contesta y cuál es su error más frecuente. Cada punto pendiente trae la liga a la guía que lo explica.

En Uso, en la misma pantalla, ve cuántas solicitudes hizo su sistema cada día de los últimos 30 días, en rojo las que terminaron en error; pase el puntero sobre un día para ver sus solicitudes, sus errores y sus facturas timbradas.

Para cambiar entre su cuenta API y sus empresas use el mismo selector; las cuentas API aparecen en su propio grupo.

Si llega desde la página de la API con Crear cuenta API y aún no tiene cuenta en Fiscalisto, primero se registra. Toda cuenta empieza con una empresa, así que en Elija su plan le ofrecemos Seguir con Gratis: esa empresa no paga nada y enseguida se abre Nueva cuenta API.

Pruebas y ProducciónCopiar enlace a esta sección

Arriba del menú elige Pruebas o Producción. Cada modo tiene sus llaves, sus emisores y sus solicitudes. En pruebas cualquier RFC sirve: las facturas se timbran sin costo con el emisor de pruebas del SAT y no son CFDI reales. En producción cada factura es un CFDI real ante el SAT y usa un timbre. El modo que elige en el panel solo cambia lo que ve; lo que decide si una factura es real es la llave con la que su sistema llama.

Para empezar de cero en pruebas, en Inicio con Pruebas elegido, vaya a Datos de prueba y pulse Reiniciar datos de prueba. Se borran las facturas, clientes, productos, lotes, ligas, descargas, eventos y solicitudes de pruebas; sus emisores, llaves y webhooks se quedan, y producción no se toca. Deje marcado Agregar clientes y productos de ejemplo para tener 3 clientes y 3 productos listos en cada emisor de pruebas, y pulse Reiniciar. Su sistema puede hacer lo mismo con POST /v1/test_data/reset y su llave fk_test_.

EjemploCopiar enlace a esta sección

Su tienda en línea quiere facturar cada pedido. Crea la cuenta API «Mi tienda», prueba con la llave fk_test_ hasta que sus facturas salen bien, agrega su RFC en Emisores con su sello digital y su e.firma, compra un paquete en Timbres y cambia su servidor a la llave fk_live_. Desde ese momento cada pedido se timbra solo.

Si algo no saleCopiar enlace a esta sección

Si no ve Nueva cuenta API en el selector, la opción aún no está abierta para su usuario. Si su llamada responde un error, abra Solicitudes: ahí está lo que mandó y lo que respondimos, con el código del error. Para invitar a alguien de su equipo a la cuenta API use Ajustes › Miembros dentro de ella; los roles para desarrolladores y la pantalla Actividad se explican en Equipo y actividad de la cuenta API.