Saltar para o conteúdo principal
Octopia (Cdiscount)

O que faz o botão Consultar estado do Octopia Connector, passo a passo

O botão Consultar estado (Poll Status) pergunta à Octopia como vai um gesto comercial que está em curso e, se a resposta trouxer um estado válido, copia-o para o gesto. Só se vê com o gesto em curso e, se o novo estado for o de concluído, pode criar uma nota de crédito em rascunho (só se a conta o tiver ativado).

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

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Onde está e quando se vê

O botão Consultar estado está na ficha do gesto comercial. Chega-se lá pelo menu Octopia › Encomendas › Gestos comerciais (Octopia › Orders › Commercial Gestures). O ramo Octopia do menu exige a permissão Utilizador Octopia (Octopia User): sem ela, não vês esse ramo. O botão existe nas versões 17, 18, 19 e 20 do Odoo.

Esquema do menu Octopia › Orders › Commercial Gestures e do botão Poll Status
Esquema feito com código a partir do código publicado do módulo (não é uma captura do Odoo): o menu e o botão, com os rótulos em inglês do código, válido para Odoo 17, 18, 19 e 20.

O botão só é visível quando o campo Estado (State) do gesto é o de em curso. Com o valor por defeito de Estado não se vê, por isso num gesto acabado de criar não o vais encontrar.

Com o Odoo em português de Portugal, o botão chama-se Consultar estado. Os rótulos de outros idiomas estão no esquema.

Esquema com o texto Poll Status em cinco idiomas
Esquema feito com código a partir dos ficheiros de tradução do módulo (não é uma captura do Odoo): em espanhol Consultar estado, em alemão Status abfragen, em francês Vérifier le statut, em italiano Verifica stato e em português Consultar estado.
48 business hours to accept each Cdiscount order. Do it in Odoo
Vídeo: 48 business hours to accept each Cdiscount order. Do it in Odoo (vídeo em inglês)

Passo a passo

  1. Abre Octopia › Encomendas › Gestos comerciais e entra no gesto. A lista mostra Encomenda (Order), Conta (Account) e Estado; a ficha mostra Encomenda, Estado e Referência do pedido (Request Reference).
  2. Vê o Estado. Se o gesto não estiver em curso, o botão não aparece e não há nada a consultar a partir daqui.
  3. Vê a Referência do pedido. É só de leitura: é preenchida pelo código, não por ti, e é preenchida pelo botão Submeter à Octopia (Submit to Octopia), que tens explicado neste outro artigo. Do facto de estar preenchida ou vazia depende a forma como a consulta é feita (passo cinco).
  4. Carrega em Consultar estado. O módulo toma a conta do gesto e prepara com ela a ligação à Octopia.
  5. Com a referência preenchida, o módulo pede à Octopia esse gesto concreto pela sua referência. Com a referência vazia, pede a lista de gestos da encomenda (usa o identificador da encomenda na Octopia) e fica com o primeiro da lista, se houver algum.
  6. O módulo lê o estado que vem na resposta. Se for um dos valores que o campo Estado admite, escreve-o no gesto.
  7. Se o novo estado for o de concluído, o módulo tenta ainda criar uma nota de crédito (explicado na secção seguinte).
  8. Verifica o resultado: vê o Estado na ficha e, se esperavas uma nota de crédito, confirma se o gesto ficou ligado a uma.

O que muda no Odoo

A única coisa que o botão altera sempre que recebe um estado válido é o campo Estado do gesto. Quando esse estado é o de concluído, o código interpreta-o como o canal ter devolvido ao cliente o valor do gesto e reflete-o com uma nota de crédito de cliente independente, em rascunho. Só é criada se se cumprirem estas condições:

  • A conta tem ativada a criação automática de notas de crédito (é opcional).
  • O gesto ainda não tem uma nota de crédito ligada.
  • A encomenda do gesto tem um cliente.

Se for criada, a nota de crédito fica assim:

  • Está em nome do cliente da encomenda e da empresa do gesto.
  • A sua referência é Gesto comercial Octopia … (…) (Octopia commercial gesture … (…)), com o identificador da encomenda na Octopia e o motivo do gesto.
  • Tem uma única linha, de quantidade um, chamada Gesto comercial - … (Commercial gesture - …) com o detalhe do motivo ou, se estiver vazio, o motivo.
  • O preço da linha é o valor do gesto, e a linha vai sem impostos: o código fá-lo assim porque esse valor é o bruto que o canal devolveu e os impostos por defeito da conta contabilística inflacioná-lo-iam.
  • O gesto fica ligado a essa nota de crédito.

A nota de crédito fica em rascunho: o código não a confirma.

Quando o gesto fica como estava

O código tem várias saídas em que o botão não altera o gesto. Convém conhecê-las para interpretar o que vês:

  • Só são processados os gestos em curso. Qualquer outro é ignorado.
  • Se a Octopia não devolver nada utilizável para o gesto (sem referência, a lista da encomenda chega vazia; ou a resposta não é um registo), o módulo passa ao seguinte e o Estado não é tocado.
  • Se o estado que chega não for nenhum dos que o Estado admite, também não é escrito.
  • Se o estado for o de concluído mas a conta não tiver ativada a criação de notas de crédito, o gesto já tiver uma nota de crédito ou a encomenda não tiver cliente, o estado é atualizado mas não é criada nenhuma nota de crédito.

Se o botão não alterou nada e esperavas uma alteração, começa pela referência: com a referência vazia o módulo fica com o primeiro gesto da lista da encomenda, não com um em concreto.

Custo e versões

O Octopia Connector é publicado na Odoo Apps para as versões 17, 18, 19 e 20, com pagamento único por versão do Odoo (o preço de cada uma, na ficha). Além disso, precisa da subscrição do FlexigoTech Cloud com o plano Conector: 49 €/mês ou 490 €/ano sem IVA, até três contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar.

Como a FlexigoTech te ajuda

Se estás a implementar o Odoo e queres que os gestos comerciais da Octopia se encaixem no teu circuito de notas de crédito e faturação, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

O que faz o botão «Submeter à Octopia» do Octopia Connector, passo a passoO que faz o botão Submeter à Octopia nas importações de faturas em massa: quando aparece, o que verifica, o que altera e o erro que pode dar.O que faz o botão «Importar» do Octopia Connector, passo a passoO que faz o botão Importar do Octopia Connector no Odoo: quando aparece, o que importa, o que muda, que aviso mostra e que entrada deixa no registo.O que faz o botão «Criar fatura de fornecedor» do Octopia ConnectorO que faz o botão Criar fatura de fornecedor do Octopia Connector no Odoo: quando aparece, o que verifica, o que cria e onde pode parar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes