Alteração
O serviço de alteração permite o envio de alterações de produtos já cadastrados, bem como o envio de aprovação de NCM e respostas das dúvidas dos analistas Systax.
Método: PUT
- URL (Alteração unitária): https://app.systax.com.br/v2/cfm/products/{id}
- URL (Alteração em lote): https://app.systax.com.br/v2/cfm/products/multi
O id é o mesmo código retornado no serviço de cadastro.
Descrição dos campos de Request e Response
Request
Os campos que podem ser enviados são:
| Nome | Tipo | Descrição |
| descricao | Texto | Descrição da mercadoria, importante para o processo de classificação |
| complemento | Texto | Informações adicionais importantes para se determina a natureza do material |
| ean | Inteiro | Número GTIN (EAN) se disponível |
| ncm_original | Inteiro | A NCM atual da mercadoria |
| ex_tipi_original | Inteiro | O EX da TIPI atual da mercadoria |
| ncm_definitiva | Inteiro | A confirmação da NCM que será utilizada. |
| ex_tipi_definitiva | Inteiro | A confirmação da EX que será utilizada, caso necessário. |
| resposta_tecnica | Texto | A resposta dada ao questionamento do analista da Systax. |
Importante: A NCM e EX definitas podem ser iguais ou diferentes à NCM sugerida pelo analista da Systax.
Response
Em caso de sucesso a API retornará o campo status com a descrição "Atualizado", caso contrário será apresentado o campo "error", com a descrição apropriada para o tipo de erro detectado.
Exemplo - Alteração unitária
Request
{
"descricao": "Teste1",
"complemento": "",
"ean": "76840002603",
"ncm_original": "21050010",
"ex_tipi_original": "",
"ncm_definitiva": "21050010",
"ex_tipi_definitiva": "",
"resposta_tecnica": "Teste"
}
Response
{
"success": true,
"message": "ok"
}
Exemplo - Alteração em lote
Request
{
"products": [
{
"id": 19511999,
"descricao": "Teste2",
"complemento": "Teste",
"ean": "",
"ncm_original": "22021000",
"ex_tipi_original": "",
"ncm_definitiva": "22021000",
"ex_tipi_definitiva": "",
"resposta_tecnica": "Resposta Teste"
},
{
"id": 19512000,
"descricao": "Teste3",
"complemento": "Teste",
"ean": "",
"ncm_original": "85049090",
"ex_tipi_original": "",
"ncm_definitiva": "85049090",
"ex_tipi_definitiva": "",
"resposta_tecnica": "Resposta Teste"
},
{
"id": 19512001,
"descricao": "Teste4",
"complemento": "Teste",
"ean": "",
"ncm_original": "22021000",
"ex_tipi_original": "",
"ncm_definitiva": "22021000",
"ex_tipi_definitiva": "",
"resposta_tecnica": "Resposta Teste"
}
]
}
Response
{
"success": true,
"message": "ok",
"itens": 3,
"itens_ok": 3,
"update_ids": [
{
"position": 0,
"cod_interno": "000002",
"origem_produto": "0",
"id": 19511999
},
{
"position": 1,
"cod_interno": "000003",
"origem_produto": "0",
"id": 19512000
},
{
"position": 2,
"cod_interno": "000004",
"origem_produto": "0",
"id": 19512001
}
],
"itens_error": 0,
"errors": []
}