Saltar para o conteúdo principal
Storecove

API Storecove no Odoo: chave na FlexigoTech Cloud, sandbox, fila de webhooks e erros

O Storecove Odoo Connector usa a API Storecove v2 (https://api.storecove.com/api/v2) e as suas chamadas passam pela FlexigoTech Cloud. A chave da API nunca fica guardada no Odoo: é enviada uma só vez, cifrada, para a FlexigoTech Cloud. Uma ação agendada consulta a fila de webhooks do Storecove a cada 5 minutos em modo pull. Um menu permite ainda enviar documentos UBL, CII ou IDOC em bruto.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 12 de novembro de 2026

O essencial

Módulo
Storecove
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0
Leitura
4 min

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.

Lista dos esquemas de identificador do conector com país, código, nome, uso B2B ou B2G, tipo de identificador e um identificador de teste em alguns países
Os esquemas de identificador do conector; em alguns países, com um identificador de teste

A fila de webhooks do Storecove, os documentos em bruto e o registo

O quêOndeQuando atua
Storecove: enviar faturas eletrónicas em filaAção agendada, ativa na instalaçãoA cada 5 minutos
Storecove: consultar fila de webhooks (modo pull)Ação agendada, ativa na instalaçãoA cada 5 minutos
Enviar Fatura de TesteMenu Storecove › FerramentasQuando o abre
Enviar Documento em Bruto (UBL/CII/IDOC)Menu Storecove › FerramentasQuando o abre
Registo de SincronizaçãoMenu Storecove › ConfiguraçãoQuando o abre

Com o menu de documento em bruto envia ao Storecove um documento UBL, CII ou IDOC.

Formulário de um envio de fatura Storecove na fila, com a barra de estado, a conta sandbox, o GUID do envio e os separadores Evidence e Request Payload
Um envio de fatura em fila, com uma API simulada e dados de demonstração

Erros da API Storecove e o que fazer

MensagemQuando apareceO 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 CloudGuarde 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 contaVolte 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 OdooGuarde 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

Storecove Peppol a partir do Odoo: entidade legal, identificador e faturasComo enviar e receber faturas por Peppol com a Storecove a partir do Odoo: entidade legal, identificador Peppol, acessibilidade do cliente e faturas recebidas.
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