GET – Listar oportunidades
| Metodo: |
GET |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades?limit=50&offset=0 |
Parametros opcionais:
limit = padrao 50, maximo 500
GET – Buscar oportunidade por ID
| Metodo: |
GET |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades/42 |
Campos úteis na resposta para os PUTs:
CRM_OP_OWNER -> EA2_ID do responsavel
CRM_OP_FUNNEL -> ID do funil
CRM_OP_STEP -> UUID da etapa atual
CRM_OP_STATUS -> 0=aberta, 1=ganha, 2=congelada, 3=perdida, 4=lixeira
POST – Criar oportunidade (prospect existente)
| Metodo: |
POST |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades |
| Header: |
Content-Type: application/json |
Body (exemplo):
{
“CRM_OP_DESC”: “Oportunidade de venda via API”,
“CRM_OP_FUNNEL”: 1,
“CRM_OP_IDEMP”: 15,
“CRM_OP_OWNER”: 7039,
“CRM_OP_VALOR”: 15000.00,
“CRM_OP_MRR”: 0
}
Campos obrigatorios:
CRM_OP_DESC = descricao da oportunidade
CRM_OP_FUNNEL = ID do funil (> 0)
CRM_OP_IDEMP = CRM_EMP_ID do prospect (ou -1 para prospect novo)
CRM_OP_OWNER = EA2_ID do responsavel (> 0)
POST – Criar oportunidade com prospect novo (CRM_OP_IDEMP = -1)
| Metodo: |
POST |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades |
| Header: |
Content-Type: application/json |
Body (exemplo):
{
“CRM_OP_DESC”: “NOVA OPORTUNIDADE COM PROSPECT NOVO”,
“CRM_OP_FUNNEL”: 497,
“CRM_OP_STEP”: “89e02f82-9038-49c4-8b51-fbe4ec7ac42a”,
“CRM_OP_IDEMP”: -1,
“CRM_OP_OWNER”: 12966,
“CRM_OP_VALOR”: 8500,
“CRM_OP_MRR”: 0,
“CRM_OP_IDORIGEM”: 0,
“CRM_EMP_RAZAO”: “NOVA EMPRESA LTDA TESTE1”,
“CRM_EMP_FANTASIA”: “FANTASIA TESTE1”,
“CRM_EMP_CNPJ”: “12345678000199”,
“CRM_EMP_CT_NOME”: “Maria Silva”,
“CRM_EMP_CT_EMAIL”: “maria@exemplo.com”,
“CRM_EMP_CT_FONE”: “11999999999”,
“CRM_EMP_CT_CARGO”: “Compras”
}
Regra adicional:
– Com CRM_OP_IDEMP = -1, CRM_EMP_RAZAO e obrigatoria
PUT – Mudar apenas a etapa da oportunidade
| Metodo: |
PUT |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades/42 |
| Header: |
Content-Type: application/json |
Body (exemplo – envie SOMENTE estes dois campos para troca de etapa):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_STEP”: “a1b2c3d4-e5f6-7890-abcd-ef1234567890”
}
Condicoes:
– Oportunidade deve estar aberta (CRM_OP_STATUS = 0)
– CRM_OP_STEP deve ser o UUID retornado em GET /etapas
– CRM_OP_STEP deve ser diferente da etapa atual
PUT – Atualizacao completa da oportunidade
| Metodo: |
PUT |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades/42 |
| Header: |
Content-Type: application/json |
Body (exemplo):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_DESC”: “Descricao atualizada via API”,
“CRM_OP_FUNNEL”: 1,
“CRM_OP_VALOR”: 20000,
“CRM_OP_MRR”: 500,
“CRM_OP_IDORIGEM”: 0
}
CRM_OP_OWNER e sempre obrigatorio no PUT.
PUT – Marcar oportunidade como ganha
| Metodo: |
PUT |
| URL: |
https://api.erpflex.com.br/api_v2/oportunidades/42 |
| Header: |
Content-Type: application/json |
Body (exemplo):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_STATUS”: 1
}
Valores de CRM_OP_STATUS:
0 = aberta
1 = ganha
2 = congelada
3 = perdida
4 = lixeira
Para status perdida (3), pode incluir:
“CRM_LOST_REASON_DESC”: “Preco”,
“CRM_LOST_OBS”: “Cliente escolheu concorrente”
Para status congelada (2), pode incluir:
“CRM_FREEZE_OBS”: “Aguardando retorno do cliente”,
“CRM_FREEZE_UNTIL”: “2026-08-01”