2.1 KiB
2.1 KiB
ClientFlow backend v4928.1.4.6 — auto-create Jasmin customer before quotation
Hotfix/feature curta para o fluxo Jasmin create_quotation.
Problema
O worker Jasmin passou a processar corretamente a outbox, mas falhava ao criar orçamento quando o cliente fiscal validado no ClientFlow ainda não existia como Customer no Jasmin:
Jasmin error 400 em GET /salesCore/customerParties/getCustomerByCompanyTaxId/<NIF>:
The company tax id provided does not correspond to an existing Customer.
Alteração
app/jasmin_service.py- Reconhece esse erro específico de Customer inexistente como caso esperado.
- Quando o cliente fiscal local está validado e tem dados mínimos, cria automaticamente o Customer no Jasmin antes do orçamento.
- Mantém erro explícito se faltarem dados obrigatórios para criar Customer: NIF, nome fiscal, morada, código postal ou cidade.
- A confirmação pós-criação por NIF deixa de bloquear o fluxo se o Jasmin ainda não indexou imediatamente o novo Customer; nesses casos usa a
partyKeyenviada e gravaconfirm_warningem metadata.
Guardrails
- Outros erros Jasmin continuam a falhar normalmente.
- Não cria Customer sem NIF.
- Não cria Customer sem nome fiscal.
- Não cria Customer sem morada fiscal mínima.
- O orçamento só é criado depois de existir
jasmin_customer_party_keylocal.
Validação local
python3 -m compileall -q app scripts tests
pytest -q tests/test_v4928_1_4_6_jasmin_autocustomer_static.py
Resultado local:
3 passed
Teste recomendado em produção
Reprocessar o item que falhou por Customer inexistente:
sudo -u postgres psql -d clientflow -c "
UPDATE integration_outbox
SET status='pending',
retry_count=0,
last_error=NULL,
locked_at=NULL,
lock_owner=NULL,
updated_at=now()
WHERE id='97a36017-4ff1-4ace-a1b0-b90cc5c5cf84';
"
OUTBOX_TARGET_SYSTEM=jasmin \
JASMIN_OUTBOX_ENABLED=true \
OUTBOX_DRY_RUN=false \
.venv/bin/python scripts/process_outbox.py
Depois confirmar se o item fica sent e se foi criado o documento Jasmin na oportunidade.