Esta API permite o controle total das produto. Veja as instruções de como realizar a integração abaixo.
Instruções para realizar a integração:
URL http://app.nectarcrm.com.br/crm/api/1/produto/
Inserir foto: POST /{id}/photo/set
Content-Type: multipart/form-data
Recebe um parâmetro: photo (arquivo de foto -- limitado em 5Mb -- extensões permitidas: jpg, png, jpeg, gif)
Ex: curl -i -X POST -H "Content-Type: multipart/form-data" -H "Access-Token: token" -F photo=@./example.jpg http://app.nectarcrm.com.br/crm/api/1/produto/{id}/photo/set
Remover foto: POST /{id}/photo/remove
Parâmetros de listagem:
- &page=x (integer) Organiza a listagem de objetos por páginas (se colocar -1, lista o máximo de objetos: 200)
Para mais informações, consulte a documentação completa clicando aqui
Schema Info | Schema JSON
| Propriedade | Tipo | Descricao |
|---|---|---|
| ativo | (boolean) | Marca se o produto está ou não ativo |
| categoria | (object) | Categoria do produto |
| codigo | (string) | Código do produto |
| comissao | (float) | Define o valor da comissão do produto (0 = não permite) |
| contador | (integer) | Código automático do produto |
| descontoMaximo | (integer) | Valor do desconto máximo permitido |
| descricao | (string) | Descrição do produto |
| editarProdutosDependentes | (boolean) | Define se é permitido ou não a remoção dos produtos dependentes nas oportunidades |
| id | (long) | Identificador no sistema |
| isComissaoPorcentual | (boolean) | Define se o valor do desconto máximo é porcentual ou real |
| isDescontoPorcentual | (boolean) | Define se o valor do desconto máximo é porcentual ou real |
| moeda | (string) | Código monetário da moeda (BRL e USD) |
| possuiEstoque | (boolean) | Define se o produto possui controle de estoque |
| produtos | (array)(produto) | Produtos dependentes |
| quantidadeEstoque | (integer) | Define a quantidade do estoque desse produto |
| recorrencia | (integer) | Recorrência de valor do produto (0 = único, 1 = mensal, 2 = anual) |
| subcategoria | (object) | SubCategoria do produto |
| valorBase | (float) | Valor base do produto |
| valorEditavel | (boolean) | Indica se o valor base do produto é ou não editável |
| fracionario | (boolean) | Indica se o produto permite quantidade fracionada |
| itensDeCusto | (array)(ItemDeCusto) | Adiciona as formações de preço do produto, e define sua precificacao do tipo composto |
| faixasPreco | (FaixaPreco) | Cria a faixa de preço do produto, e define sua precificacao do tipo faixa de preço |
| valorBaseComposto | (float) | Determina o valor base de um produto com precificação do tipo composto |
Exemplo
[
{
"ativo": true,
"categoria": {
"ativo": true,
"id": 7,
"nome": "Categoria de produto 1"
},
"codigo": "2.1",
"comissao": 0,
"isComissaoPorcentual": true,
"contador": 128,
"descontoMaximo": 15,
"isDescontoPorcentual": true,
"id": 1,
"moeda": "BRL",
"nome": "Nome do produto",
"permiteDesconto": true,
"possuiEstoque": false,
"recorrencia": 1,
"subCategoria": {
"ativo": true,
"id": 2,
"nome": "Manutenção"
},
"valorBase": 150,
"fracionario": false,
"produtos": [
{
"id": 2,
"nome" : "Nome do produto dependente",
"contador": 129,
"ativo": true,
"valorBase" : 100,
"recorrencia": 0,
"permiteDesconto": true,
"codigo": "p2",
"moeda": "BRL",
"descontoMaximo": 10,
"comissao": 0,
"isComissaoPorcentual": true,
"descontoMaximo": 15,
"isDescontoPorcentual": true
}
],
"editarProdutosDependentes": false,
"itensDeCusto": [//quando precificação do tipo composta
{
"id": 1,//id da formacao de preço para pesquisa na base
"nome": "Formação 1",//nome da formação de preço para pesquisa na base
"valor": 300.00,
"quantidade": 2.0,
"valorBase":300.00,//necessario apenas quando a formacao de preço nao for encontrada na base, será criada.
"porcentagem":false,//necessario apenas quando a formacao de preço nao for encontrada na base, será criada.
"multiplicador":false//necessario apenas quando a formacao de preço nao for encontrada na base, será criada.
}
],
"valorBaseComposto": 200.59,
"faixasPreco": [//quando precificação do tipo faixa de preço
{
"quantidadeInicial": 0,
"quantidadeFinal": 10,
"valor": 300.00
},
{
"quantidadeInicial": 11,
"quantidadeFinal": 20,
"valor": 270.00
}
]
}
]