66 lines
2.1 KiB
Markdown
66 lines
2.1 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
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 `partyKey` enviada e grava `confirm_warning` em 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_key` local.
|
|
|
|
## Validação local
|
|
|
|
```bash
|
|
python3 -m compileall -q app scripts tests
|
|
pytest -q tests/test_v4928_1_4_6_jasmin_autocustomer_static.py
|
|
```
|
|
|
|
Resultado local:
|
|
|
|
```text
|
|
3 passed
|
|
```
|
|
|
|
## Teste recomendado em produção
|
|
|
|
Reprocessar o item que falhou por Customer inexistente:
|
|
|
|
```bash
|
|
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.
|