Que API Storecove usa o conector e o que precisa
O conector trabalha com https://api.storecove.com/api/v2. Segundo a sua ficha, envia faturas e notas de crédito por Peppol, SDI, KSeF, FACeB2B e mais de 30 redes. Traz também para o Odoo as faturas de fornecedor e as encomendas.
Precisa de:
- Uma conta Storecove. A ficha indica que há uma sandbox gratuita de 30 dias.
- A subscrição da FlexigoTech Cloud (plano Conector). A conta que criar guarda lá a sua chave, nunca no Odoo.
As entidades legais, o identificador de cada contacto e o envio de faturas estão em Storecove Peppol a partir do Odoo.
A chave da API Storecove e o consentimento
Cria a conta Storecove no Odoo e a chave vai para o campo API key (FlexigoTech Cloud). A sua ajuda diz: Sent once, encrypted, to FlexigoTech Cloud. It is never stored in Odoo.
Antes de a guardar, um administrador tem de aceitar que a chave e as chamadas ao Storecove passam pela FlexigoTech Cloud. Se não o fez, o conector pára com esta mensagem:
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.
Apagar a chave da FlexigoTech Cloud também cabe a um administrador. Outro utilizador vê Only an administrator can delete the Storecove API key from FlexigoTech Cloud.
Sandbox e produção na API Storecove
Uma conta Storecove no Odoo está Não Ligada, Ligada ou Erro de Ligação. O arranque rápido do conector começa por criar a conta com a sua chave e usar Testar Ligação.
O conector inclui um catálogo de esquemas de identificador que cobre mais de 50 países, com identificadores de teste para a sandbox. Para enviar uma fatura de teste tem Storecove › Ferramentas › Enviar Fatura de Teste.

A fila de webhooks do Storecove, os documentos em bruto e o registo
| O quê | Onde | Quando atua |
|---|---|---|
Storecove: enviar faturas eletrónicas em fila | Ação agendada, ativa na instalação | A cada 5 minutos |
Storecove: consultar fila de webhooks (modo pull) | Ação agendada, ativa na instalação | A cada 5 minutos |
Enviar Fatura de Teste | Menu Storecove › Ferramentas | Quando o abre |
Enviar Documento em Bruto (UBL/CII/IDOC) | Menu Storecove › Ferramentas | Quando o abre |
Registo de Sincronização | Menu Storecove › Configuração | Quando o abre |
Com o menu de documento em bruto envia ao Storecove um documento UBL, CII ou IDOC.

Erros da API Storecove e o que fazer
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
Save the API key of … in FlexigoTech Cloud first: nothing was sent. | A chave dessa conta ainda não foi guardada na FlexigoTech Cloud | Guarde a chave na secção FlexigoTech Cloud da conta |
The API key of … is not saved in FlexigoTech Cloud: type it again. | A FlexigoTech Cloud não tem nenhuma chave guardada para essa conta | Volte a escrever a chave |
This Storecove account goes through FlexigoTech Cloud: its API key is kept there, never in Odoo. Save it in the FlexigoTech Cloud section. | Ao tentar guardar a chave no Odoo | Guarde a chave na secção FlexigoTech Cloud |
Um imposto por linha
Segundo o aviso do conector, cada linha da fatura eletrónica precisa de exatamente um imposto percentual de IVA/GST. O aviso aparece quando uma linha não tem exatamente um imposto ou quando esse imposto não é percentual. Indica a linha, quantos impostos tem e de que tipo. As taxas fixas, como as ecotaxas ou o DEEE, vão como linhas separadas ou como desconto ou abatimento.
Redirecionamentos
Se o Storecove responder a uma chamada feita através da FlexigoTech Cloud com um código HTTP igual ou superior a 300 e inferior a 400, o conector devolve Storecove answered … … with an unexpected HTTP redirect (…) through FlexigoTech Cloud. O aviso indica o método, o caminho e o código HTTP.
Notificações mal formadas
O conector verifica que cada notificação do Storecove é um objeto JSON e que as de document_submission trazem um guid. Se não, devolve O corpo do webhook não é um objeto JSON. ou Webhook document_submission sem guid.
Perguntas sobre a API Storecove com o Odoo
O Odoo guarda a chave da API Storecove?
Não. É enviada uma só vez, cifrada, para a FlexigoTech Cloud e nunca fica guardada no Odoo. Só um administrador a pode apagar de lá.
Com que frequência o Odoo consulta a fila de webhooks do Storecove?
A cada 5 minutos, através da ação agendada Storecove: consultar fila de webhooks (modo pull), ativa assim que o conector está instalado.
Posso enviar eu próprio um documento UBL, CII ou IDOC?
Sim, a partir de Storecove › Ferramentas › Enviar Documento em Bruto (UBL/CII/IDOC).
Preciso da subscrição da FlexigoTech Cloud para usar a API Storecove?
Sim. O conector precisa da subscrição da FlexigoTech Cloud (plano Conector), porque a chave e as chamadas ao Storecove passam por ela. Encontra-a na Odoo Apps e na página do conector em flexigotech.com.
Continue a ler
Verificado no código do conector (versão 20.0)
Fontes
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): __manifest__.py
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_api_client.py
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/fgt_cloud.py
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): data/storecove_cron_data.xml
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): views/menu.xml
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_account.py
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): README.md
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_document_submission.py
- Código do módulo: flexigobe_storecove_connector 20.0 (a76bb9d4): models/storecove_invoice_builder.py
