Ligar os reembolsos do Shopify às notas de crédito no InvoiceXpress
Quando uma loja online está ligada ao programa de faturação, os dados da venda podem passar de um sistema para o outro sem que alguém tenha de voltar a preencher os artigos e os valores. A equipa acompanha as encomendas na loja e encontra os documentos correspondentes no programa de faturação.
Se essa ligação ainda não tratar os reembolsos, uma devolução volta a exigir trabalho separado. Quem trata da faturação precisa de encontrar o documento da venda, perceber que parte da compra foi reembolsada e preparar o documento adequado. Quando o cliente fica com alguns artigos e devolve os restantes, é necessário recuperar o detalhe da venda para tratar apenas a parte abrangida.
É possível completar a integração para aproveitar a informação que já existe na loja. O percurso que se segue descreve uma solução a implementar entre o Shopify e o InvoiceXpress: receber o reembolso, relacioná-lo com a venda e preparar a nota de crédito segundo as regras definidas pela empresa. Ao guardar também o que foi feito, a integração permite à equipa acompanhar os assuntos pendentes sem reconstruir o processo em cada consulta.
Recuperar a venda a partir do reembolso
O início deste percurso é o registo de um reembolso no Shopify. A loja pode enviar um aviso automático, chamado webhook, para que a integração saiba que há informação nova a tratar. A partir desse aviso, a integração consulta o reembolso e recupera a encomenda a que pertence, juntamente com o detalhe disponível sobre os artigos e os valores abrangidos.
A devolução física dos artigos, o movimento financeiro do reembolso e o tratamento na faturação são acontecimentos distintos. Podem ocorrer em momentos diferentes. Em particular, o aviso de criação de um reembolso no Shopify não confirma, por si só, que o dinheiro foi devolvido ao cliente. O responsável pela faturação define em que momento se prepara ou finaliza o documento; se esse passo depender da confirmação financeira, a integração terá de consultar o estado das transações associadas. A referência de reembolsos do Shopify descreve os dados disponíveis e essa distinção.
Para chegar à fatura, a integração aproveita a relação entre a encomenda e o documento emitido. Essa relação pode ficar guardada logo na faturação da venda, de forma que um reembolso posterior encontre diretamente o documento correspondente. Se uma encomenda tiver dado origem a vários documentos, é preciso conservar também a correspondência entre as linhas da encomenda e os documentos onde foram faturadas.
Nas vendas antigas, poderá ser necessário recuperar essa associação através das referências já registadas. Quando a informação não permitir identificar o documento com segurança, a equipa recebe o assunto para o completar. Depois de confirmada a ligação, ela fica disponível para os passos seguintes e para outros reembolsos da mesma encomenda.
Tratar apenas a parte reembolsada
Considere o caso de um cliente que devolve parte dos artigos de uma encomenda já faturada e recebe o reembolso correspondente. A integração encontra as linhas abrangidas e recupera as quantidades e as condições usadas na venda. Assim, a preparação documental parte do que foi efetivamente faturado, incluindo os descontos aplicados, em vez de usar o preço atual do catálogo.
A informação sobre portes ou outros acertos precisa igualmente de ter um destino definido nas regras da empresa. Um valor global de reembolso pode não chegar para perceber como deve ser repartido. Nessa situação, o assunto fica para decisão da equipa, acompanhado dos dados já recuperados. A pessoa responsável completa a repartição e permite que o tratamento prossiga.
Pode surgir mais tarde outro reembolso da mesma encomenda, relativo a artigos que o cliente tinha conservado. Por isso, cada reembolso precisa de ser identificado separadamente, mantendo a ligação à encomenda comum. Marcar apenas a encomenda como tratada impediria que esta nova alteração avançasse.
O histórico deve mostrar o que já foi abrangido por documentos anteriores, incluindo os que tenham sido preparados manualmente. Com essa informação, a equipa consegue acompanhar as devoluções sucessivas sem voltar a incluir uma quantidade que já tinha sido tratada.
Preparar o documento e acompanhar a conclusão
Quando existe informação suficiente, a integração envia ao InvoiceXpress os dados necessários para preparar a nota de crédito e associá-la ao documento original. A API, a ligação que o programa disponibiliza para receber pedidos de outros sistemas, permite criar notas de crédito com essa associação.
A preparação pode terminar num rascunho disponível para revisão. Quem trata da faturação abre o documento, consulta a relação com a venda e revê o que foi preparado. Nos casos em que a empresa tenha definido regras suficientes para prosseguir automaticamente, a integração pode também pedir a finalização. O InvoiceXpress disponibiliza uma operação própria para alterar o estado do documento.
O acompanhamento deve conservar esta diferença. Um documento preparado ainda pode aguardar revisão; um pedido de finalização enviado ainda pode aguardar confirmação. Ao mostrar a etapa efetivamente confirmada pelo programa, a integração permite perceber se a equipa já pode considerar o assunto concluído ou se falta alguma ação.
As decisões sobre o documento a emitir e os valores a incluir pertencem ao processo de faturação da empresa. O trabalho técnico consiste em aplicar essas decisões aos dados da loja e em conservar a ligação entre o reembolso e o resultado no InvoiceXpress.
Retomar o trabalho sem criar outro documento
Para a equipa poder retomar um assunto, a integração guarda o estado do tratamento de forma persistente, juntamente com a identificação da loja, do reembolso e dos documentos associados. Estes registos continuam disponíveis depois de terminar uma execução ou de o serviço ser reiniciado.
Isto também permite reconhecer avisos repetidos. O Shopify pode entregar o mesmo aviso mais de uma vez, como explica nas suas orientações sobre a receção de webhooks. Ao receber uma repetição, a integração recupera o tratamento existente e consulta o que já aconteceu. A implementação tem ainda de coordenar pedidos simultâneos, para que não comecem duas criações para o mesmo reembolso.
Há uma situação em que essa continuidade é especialmente útil: o InvoiceXpress pode receber um pedido e criar o documento, mas a resposta perder-se antes de chegar à integração. Repetir imediatamente a criação poderia produzir outro documento. O assunto deve ficar a aguardar confirmação enquanto a integração procura o resultado do pedido anterior. O InvoiceXpress permite identificar o processo para prevenir pedidos duplicados; essa proteção deve ser usada em conjunto com o registo do pedido e a recuperação do seu resultado.
Na ferramenta onde acompanha o trabalho, a equipa encontra os casos por resolver com acesso à encomenda, ao documento conhecido e à razão concreta da paragem. Se faltava identificar a fatura, a pessoa completa essa associação. Se faltava confirmar uma criação, consulta o resultado e associa o documento encontrado. Depois, o mesmo tratamento continua a partir do ponto em que ficou.
Uma consulta periódica aos reembolsos da loja pode ainda recuperar assuntos cujo aviso não tenha chegado. Como utiliza o mesmo histórico, essa consulta distingue o trabalho em falta do que já está concluído.
Aproveitar a integração que já existe
O primeiro passo técnico é perceber se a ligação utilizada pela empresa já oferece este tratamento e se cobre os seus casos de reembolso parcial. Quando essa capacidade existe, poderá bastar configurá-la e ajustá-la ao processo de faturação.
Se for necessário completar a ligação, uma plataforma de automatização pode coordenar as consultas e os pedidos entre programas. Um componente próprio pode justificar-se quando é preciso controlar regras específicas ou dar à equipa uma forma particular de rever e retomar os assuntos. As duas opções podem coexistir; a escolha depende do comportamento necessário e de quem irá manter a solução.
Neste percurso, os dados já têm identificadores e campos definidos, pelo que o núcleo da solução pode funcionar com regras convencionais, sem IA. O trabalho de implementação está em estabelecer as correspondências, aplicar o tratamento acordado e acompanhar as respostas dos sistemas. Para delimitar esse trabalho, são úteis os casos que a equipa já resolve manualmente, sobretudo os parciais e os que exigem consultar mais do que um documento.
Se os reembolsos da sua loja ainda exigem este trabalho separado, entre em contacto comigo para avaliar como completar a ligação à faturação e implementar o tratamento adequado à sua equipa.