Oportunidade
POST
/erp-oportunidades
Cliente
cpfCnpj. Se já existir, os campos enviados atualizam ocadastro; os campos omitidos são mantidos. Se não existir, o cliente é criado com situação
PD, contribuinte de ICMS = Não, e Inscrição Estadual/Municipal gravadas como ISENTO.Identificação do produto (itens[].idProduto)
idProduto aceita qualquer um destes códigos da variante do produto:| Código | Onde está no ERP | Unicidade |
|---|---|---|
| Código ERP da variante | Cadastro de Produtos → código da variante | Único |
| Código legado (referência do sistema de origem) | Cadastro de Produtos → código legado | Não é garantido único |
de uma variante, o produto usado não é determinístico. Nesses casos, envie o código ERP.
Idempotência
pedidoCliente for enviado e já existir uma oportunidade não cancelada com o mesmo númerona mesma unidade, a requisição é recusada com 400
(
Pedido já existe no ERP, número origem: ...).Valores
valor do pedido = soma de itens[].valorTotal. O servidor não recalcula o total doitem a partir de quantidade, preço e desconto: envie valores já consistentes.
Requisição
Parâmetros Bodyapplication/jsonObrigatório
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/erp-oportunidades' \
--header 'WGX-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"codigoUnidade": "10001",
"codigoVendedor": 51,
"situacao": "PD",
"tipo": "PV",
"pedidoCliente": "LOJA-000123",
"dataAbertura": "2026-09-25",
"horaAbertura": "10:30:00",
"dataFechamento": "2026-09-25",
"horaFechamento": "10:30:00",
"observacoes_comerciais": "Entregar em horário comercial",
"enviaPDV": false,
"cliente": {
"cpfCnpj": "11.222.333/0001-81",
"nome": "Empresa Exemplo Ltda",
"nomeFantasia": "Exemplo",
"email": "financeiro@exemplo.com.br",
"celular": "85998098877",
"endereco": {
"logradouro": "Rua das Flores",
"numero": "100",
"bairro": "Centro",
"cep": "60000000",
"uf": "CE",
"idMunicipio": "2304400",
"nomeMunicipio": "Fortaleza"
}
},
"itens": [
{
"idProduto": "S000002",
"quantidade": 1,
"valorUnitario": 175,
"percentualValorDesconto": 0,
"valorDesconto": 0,
"valorTotal": 175
}
],
"pagamentos": [
{
"finalizadora": "DIN",
"prazo": "1X",
"valor": 175,
"vencimento": "2026-09-25"
}
]
}'Response Response Example
201 - Sucesso
{
"isSuccess": true,
"status": "CREATED",
"date": "2026-09-25T10:30:01",
"contentType": "application/json",
"content": 60400000123456
}Modificado em 2026-09-25 17:51:04