Integraciones, API y webhooks

Integraciones reúne las formas en que tus ventas llegan a Fiscalbase sin escribirlas, en la lista Conectar: la app para Shopify, que factura cada pedido pagado con una API key de este ambiente (mientras no esté activa para tu organización dice «Próximamente»); tu propio sistema, por API y Webhooks; y tu sistema anterior, con Importar historial.

Las tiendas de Shopify ya conectadas aparecen en Conectadas, con su dominio, desde cuándo están conectadas y su estado: conectada, en pausa (la app espera que corrijas algo que Fiscalbase pidió, como una numeración) o desconectada. Es lo que la app de Shopify le informa a Fiscalbase con tu propia API key cada vez que cambia algo, y cada hora.

API keysCopiar enlace a esta sección

En API están las API keys del negocio y el ambiente en los que estás, cada una con su nombre y sus primeros caracteres (fb_live_Ab12…). Cada API key es de un solo negocio, emite solo en su ambiente y empieza por su prefijo: fb_sandbox_, fb_test_ o fb_live_. Solo un propietario o un administrador las ve y las gestiona; los miembros ven un aviso.

• Nueva API key: le das un Nombre que diga para qué la usas («Servidor de producción», «Shopify»), el Ambiente (un negocio de Sandbox solo tiene Sandbox; uno en vivo elige entre Pruebas y Producción) y un Permiso: Completo, Solo lectura o Sin emitir en Producción. La API key completa aparece una sola vez, con un ejemplo de curl: cópiala entonces. Si la pierdes, revócala y crea otra.
• Al abrir una API key ves su permiso, quién la creó, cuándo y su último uso.
• Revocar API key la desactiva al instante: lo que la use recibe 401.

Debajo, Solicitudes recientes lista las últimas llamadas de las API keys de este negocio y ambiente, de diez en diez, con su estado y cuánto tardaron. Lee más en API keys.

WebhooksCopiar enlace a esta sección

En Webhooks añades las direcciones a las que te avisamos cuando el SRI decide sobre un comprobante, cuando registras una anulación o cuando termina una importación (eventos). Cada destino muestra cómo le fue su última entrega, y los destinos son del negocio y el ambiente en los que estás.

• Nuevo destino: su URL (HTTPS en una dirección pública, también en Sandbox) y sus eventos, todos o los que elijas. El secreto de firma whsec_… aparece una sola vez; después el destino muestra solo whsec_… y sus últimos cuatro caracteres, para que reconozcas cuál es. Un destino creado antes de esa pista muestra Uno.
• Al abrir Webhooks ves las Entregas recientes de un destino, que puedes filtrar por Todas, Fallidas, Reintentando y Entregadas, con sus intentos y lo que respondió tu sistema. Reenviar, en una entrega fallida, repite el evento como una entrega nueva; no cambia el comprobante.
• Rotar crea un secreto nuevo. El anterior sigue firmando 24 o 72 horas, así cada entrega lleva dos firmas y tu sistema cambia de secreto sin perder ninguna; o deja de valer Ahora mismo, si se filtró.
• Recibir eventos, en el destino, lo pausa sin borrarlo; Eliminar destino lo borra con su registro de entregas.

Una entrega fallida nunca frena la emisión.