Integraciones, API y webhooks

Integraciones reúne las formas en que tus ventas llegan a Fiscalbase sin escribirlas: la app para Shopify, que se conecta con una clave de este ambiente; tu propio sistema, por la API y los 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 clave cada vez que cambia algo, y cada hora; la lista está en GET /v1/shopify-connections.

Claves APICopiar enlace a esta sección

En API están las claves del ambiente en el que estás: cada una emite solo allí 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.

• Crear clave: le das un nombre que diga para qué la usas («Servidor de producción», «Shopify»). La clave completa aparece una sola vez: cópiala entonces. Si la pierdes, revócala y crea otra.
• La lista reconoce cada clave por sus primeros caracteres (fb_live_Ab12…), con quién la creó y cuándo se usó por última vez.
• Revocar la desactiva al instante: lo que la use recibe 401.

La página también muestra una primera solicitud con curl para ese ambiente. Lee más en Claves API.

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.

• Añadir destino: su dirección (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 la lista muestra solo whsec_… y sus últimos cuatro caracteres (secret_hint) para que reconozcas cuál es. Un destino creado antes de esa pista la muestra al rotar el secreto.
• Al abrir un destino ves sus entregas, filtradas por estado, con sus intentos y lo que respondió tu sistema. Reenviar repite una entrega fallida como una nueva; no cambia el comprobante.
• Rotar secreto crea uno 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 enseguida, si se filtró.
• Pausar detiene las entregas sin borrar el destino; Eliminar lo borra con su registro.

Una entrega fallida nunca frena la emisión.