Qué API de Storecove usa el conector y qué necesitas
El conector trabaja contra https://api.storecove.com/api/v2. Según su ficha, envía facturas y abonos por Peppol, SDI, KSeF, FACeB2B y más de 30 redes. También trae a Odoo facturas de proveedor y pedidos.
Necesitas:
- Una cuenta de Storecove. La ficha indica que hay una cuenta de pruebas (sandbox) gratuita de 30 días.
- La suscripción a FlexigoTech Cloud (plan Conector). La cuenta que creas guarda su clave allí, nunca en Odoo.
Las entidades legales, el identificador de cada contacto y el envío de facturas los tienes en Storecove Peppol desde Odoo.
La clave de la API de Storecove y el consentimiento
La cuenta de Storecove se crea en Odoo, y la clave va en el campo Clave de API (FlexigoTech Cloud). Su ayuda dice: Se envía una vez, cifrada, a FlexigoTech Cloud. Nunca se guarda en Odoo.
Antes de guardarla, un administrador tiene que aceptar que la clave y las llamadas a Storecove pasen por FlexigoTech Cloud. Si no lo ha hecho, el conector para con este mensaje:
Antes de guardar la clave de API, un administrador tiene que aceptar que la clave y las llamadas a Storecove pasen por FlexigoTech Cloud. No se ha enviado nada.
Borrar la clave de FlexigoTech Cloud también es cosa de un administrador. Otro usuario verá Solo un administrador puede borrar la clave de API de Storecove de FlexigoTech Cloud.
Sandbox y producción en la API de Storecove
Una cuenta de Storecove en Odoo está en No conectada, Conectada o Error de conexión. La guía rápida del conector empieza por crear la cuenta con su clave y usar Probar conexión.
El conector trae un catálogo de esquemas de identificador de más de 50 países, con identificadores de prueba para sandbox. Para mandar una factura de prueba tienes Storecove › Herramientas › Enviar factura de prueba.

La cola de avisos de Storecove, los documentos sin procesar y el registro
| Qué | Dónde | Cuándo actúa |
|---|---|---|
Storecove: enviar facturas electrónicas en cola | Tarea programada, activa al instalar | Cada 5 minutos |
Storecove: consultar cola de webhooks (modo pull) | Tarea programada, activa al instalar | Cada 5 minutos |
Enviar factura de prueba | Menú Storecove › Herramientas | Cuando lo abres |
Enviar documento sin procesar (UBL/CII/IDOC) | Menú Storecove › Herramientas | Cuando lo abres |
Registro de sincronización | Menú Storecove › Configuración | Cuando lo abres |
Con el menú de documentos sin procesar mandas a Storecove un documento UBL, CII o IDOC.

Errores de la API de Storecove y qué hacer
| Mensaje | Cuándo sale | Qué hacer |
|---|---|---|
Guarde primero la clave de API de … en FlexigoTech Cloud: no se ha enviado nada. | La clave de esa cuenta todavía no se ha guardado en FlexigoTech Cloud | Guarda la clave en la sección FlexigoTech Cloud de la cuenta |
La clave de API de … no está guardada en FlexigoTech Cloud: escríbala otra vez. | FlexigoTech Cloud no tiene guardada la clave de esa cuenta | Escribe la clave otra vez |
Esta cuenta de Storecove va por FlexigoTech Cloud: su clave de API se guarda allí, nunca en Odoo. Guárdela en la sección FlexigoTech Cloud. | Al intentar guardar la clave en Odoo | Guarda la clave en la sección FlexigoTech Cloud |
Un impuesto por línea
Según el aviso del conector, cada línea de la factura electrónica necesita exactamente un impuesto porcentual de IVA/GST. El aviso sale cuando una línea no tiene un solo impuesto o cuando ese impuesto no es porcentual. Nombra la línea, cuántos impuestos tiene y de qué tipo. Las tasas fijas, como ecotasas o DEEE, van como líneas aparte o como un descuento o recargo.
Redirecciones
Si Storecove contesta a una llamada que pasa por FlexigoTech Cloud con un código HTTP de 300 o más y menor de 400, el conector da Storecove ha respondido a … … con una redirección HTTP inesperada (…) a través de FlexigoTech Cloud. El aviso dice el método, la ruta y el código HTTP.
Avisos mal formados
El conector comprueba que cada aviso de Storecove sea un objeto JSON y que los de document_submission traigan guid. Si no, da El cuerpo del webhook no es un objeto JSON. o Webhook document_submission sin guid.
Preguntas sobre la API de Storecove con Odoo
¿Odoo guarda la clave de API de Storecove?
No. Se envía una vez, cifrada, a FlexigoTech Cloud, y nunca se guarda en Odoo. Solo un administrador puede borrarla de allí.
¿Cada cuánto consulta Odoo la cola de avisos de Storecove?
Cada 5 minutos, con la tarea Storecove: consultar cola de webhooks (modo pull), activa al instalar el conector.
¿Puedo enviar un documento UBL, CII o IDOC por mi cuenta?
Sí, desde Storecove › Herramientas › Enviar documento sin procesar (UBL/CII/IDOC).
¿Necesito la suscripción a FlexigoTech Cloud para usar la API de Storecove?
Sí. El conector necesita la suscripción a FlexigoTech Cloud (plan Conector), porque la clave y las llamadas a Storecove pasan por allí. Lo tienes en Odoo Apps y en la página del conector en flexigotech.com.
Sigue leyendo
Comprobado en el código del conector (versión 20.0)
Fuentes
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
- Código del módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py
