Saltar al contenido principal
Storecove

Storecove API en Odoo: clave en FlexigoTech Cloud, cuenta de pruebas, cola y errores

Storecove Odoo Connector usa la API v2 de Storecove (https://api.storecove.com/api/v2), y sus llamadas pasan por FlexigoTech Cloud. La clave de API nunca se guarda en Odoo: se envía una vez, cifrada, a FlexigoTech Cloud. Una tarea programada consulta cada 5 minutos la cola de webhooks de Storecove en modo pull. Además, un menú te deja enviar documentos UBL, CII o IDOC sin procesar.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 12 de noviembre de 2026

Lo esencial

Módulo
Storecove
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0
Lectura
4 min

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.

Lista de esquemas de identificador del conector con país, código, nombre, uso B2B o B2G, clase de identificador e identificador de prueba en algunos países
Los esquemas de identificador del conector; en algunos países, con un identificador de prueba

La cola de avisos de Storecove, los documentos sin procesar y el registro

QuéDóndeCuándo actúa
Storecove: enviar facturas electrónicas en colaTarea programada, activa al instalarCada 5 minutos
Storecove: consultar cola de webhooks (modo pull)Tarea programada, activa al instalarCada 5 minutos
Enviar factura de pruebaMenú Storecove › HerramientasCuando lo abres
Enviar documento sin procesar (UBL/CII/IDOC)Menú Storecove › HerramientasCuando lo abres
Registro de sincronizaciónMenú Storecove › ConfiguraciónCuando lo abres

Con el menú de documentos sin procesar mandas a Storecove un documento UBL, CII o IDOC.

Formulario de un envío de factura por Storecove en cola, con la barra de estados, la cuenta de sandbox, el GUID del envío y las pestañas Evidence y Request Payload
Un envío de factura en cola, con API simulada y datos de demostración

Errores de la API de Storecove y qué hacer

MensajeCuándo saleQué 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 CloudGuarda 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 cuentaEscribe 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 OdooGuarda 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

Storecove Peppol desde Odoo: entidad legal, identificador y facturasCómo enviar y recibir facturas por Peppol con Storecove desde Odoo: entidad legal, identificador Peppol, alcance del cliente y facturas que llegan.
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