Salta al contingut principal
Storecove

API de Storecove a Odoo: clau a FlexigoTech Cloud, sandbox, cua de webhooks i errors

Storecove Odoo Connector utilitza l'API v2 de Storecove (https://api.storecove.com/api/v2), i les seves crides passen per FlexigoTech Cloud. La clau d'API no es guarda mai a Odoo: s'envia una sola vegada, xifrada, a FlexigoTech Cloud. Una acció planificada consulta la cua de webhooks de Storecove cada 5 minuts en mode pull. Un menú permet a més enviar documents UBL, CII o IDOC en brut.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 12 de novembre de 2026

L'essencial

Mòdul
Storecove
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0
Lectura
4 min

Quina API de Storecove fa servir el connector i què necessites

El connector treballa contra https://api.storecove.com/api/v2. Segons la seva fitxa, envia factures i factures rectificatives per Peppol, SDI, KSeF, FACeB2B i més de 30 xarxes. També porta a Odoo factures de proveïdors i comandes.

Necessites:

  • Un compte de Storecove. La fitxa diu que hi ha un sandbox gratuït de 30 dies.
  • La subscripció a FlexigoTech Cloud (pla Connector). El compte que creïs hi guarda la seva clau, mai a Odoo.

Les entitats legals, l'identificador de cada contacte i l'enviament de factures es tracten a Storecove Peppol des d'Odoo.

La clau d'API de Storecove i el consentiment

Crees el compte de Storecove a Odoo i la clau va al camp API key (FlexigoTech Cloud). La seva ajuda diu: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.

Abans de desar-la, un administrador ha d'acceptar que la clau i les crides a Storecove passen per FlexigoTech Cloud. Si no ho ha fet, el connector s'atura amb aquest missatge:

Before saving the API key, an administrator has to accept that the key and the calls to Storecove go through FlexigoTech Cloud. Nothing was sent.

Esborrar la clau de FlexigoTech Cloud també correspon a un administrador. Un altre usuari veu Only an administrator can delete the Storecove API key from FlexigoTech Cloud.

Sandbox i producció a l'API de Storecove

Un compte de Storecove a Odoo pot estar en estat Not Connected, Connected o Connection Error. L'inici ràpid del connector comença creant el compte amb la seva clau i fent servir Test Connection.

El connector inclou un catàleg d'esquemes d'identificador que cobreix més de 50 països, amb identificadors de prova per al sandbox. Per enviar una factura de prova tens Storecove › Tools › Send Test Invoice.

Llista dels esquemes d'identificador del connector amb país, codi, nom, ús B2B o B2G, tipus d'identificador i un identificador de prova en alguns països
Els esquemes d'identificador del connector; en alguns països, amb un identificador de prova

La cua de webhooks de Storecove, els documents en brut i el registre

QuèOnQuan actua
Storecove: send queued e-invoicesAcció planificada, activa en instal·larCada 5 minuts
Storecove: poll webhook queue (pull mode)Acció planificada, activa en instal·larCada 5 minuts
Send Test InvoiceMenú Storecove › ToolsQuan l'obres
Send Raw Document (UBL/CII/IDOC)Menú Storecove › ToolsQuan l'obres
Sync LogMenú Storecove › ConfigurationQuan l'obres

Amb el menú de document en brut envies a Storecove un document UBL, CII o IDOC.

Formulari d'un enviament de factura de Storecove a la cua, amb la barra d'estat, el compte sandbox, el GUID de l'enviament i les pestanyes Evidence i Request Payload
Un enviament de factura a la cua, amb una API simulada i dades de demostració

Errors de l'API de Storecove i què fer

MissatgeQuan apareixQuè fer
Save the API key of … in FlexigoTech Cloud first: nothing was sent.Encara no s'ha desat a FlexigoTech Cloud la clau d'aquest compteDesa la clau a la secció FlexigoTech Cloud del compte
The API key of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud no té cap clau guardada per a aquest compteTorna a escriure la clau
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section.En intentar desar la clau a OdooDesa la clau a la secció FlexigoTech Cloud

Un sol impost per línia

Segons l'avís del connector, cada línia de la factura electrònica necessita exactament un impost percentual d'IVA/GST. L'avís apareix quan una línia no té exactament un impost o quan aquest impost no és percentual. Anomena la línia, quants impostos té i de quin tipus. Les quotes fixes, com les ecotaxes o els RAEE, van en línies a part o com a descompte o recàrrec.

Redireccions

Si Storecove respon a una crida feta a través de FlexigoTech Cloud amb un codi d'estat HTTP de 300 o més i inferior a 400, el connector mostra Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. L'avís dona el mètode, la ruta i el codi d'estat HTTP.

Notificacions mal formades

El connector comprova que cada notificació de Storecove sigui un objecte JSON i que les de document_submission portin un guid. Si no, mostra Webhook body is not a JSON object. o document_submission webhook without guid.

Preguntes sobre l'API de Storecove amb Odoo

Odoo guarda la clau d'API de Storecove?

No. S'envia una sola vegada, xifrada, a FlexigoTech Cloud, i no es guarda mai a Odoo. Només un administrador pot esborrar-la d'allà.

Cada quant revisa Odoo la cua de webhooks de Storecove?

Cada 5 minuts, mitjançant l'acció planificada Storecove: poll webhook queue (pull mode), activa un cop instal·lat el connector.

Puc enviar jo mateix un document UBL, CII o IDOC?

Sí, des de Storecove › Tools › Send Raw Document (UBL/CII/IDOC).

Necessito la subscripció a FlexigoTech Cloud per fer servir l'API de Storecove?

Sí. El connector necessita la subscripció a FlexigoTech Cloud (pla Connector), perquè la clau i les crides a Storecove hi passen. La trobaràs a Odoo Apps i a la pàgina del connector a flexigotech.com.

Continua llegint

Storecove Peppol des d'Odoo: entitat legal, identificador i facturesCom enviar i rebre factures per Peppol amb Storecove des d'Odoo: entitat legal, identificador Peppol, abast del client i factures que arriben.
Comprovat al codi del connector (versió 20.0)

Fonts

  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
  • Codi del mòdul: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py