API - Cadastro de produtos em lote
Objetivo: Cadastrar mais de 1 produto em uma única requisição.
Método: POST
API Rest / Json: https://wscockpit.systax.com.br/api/api/carga_produto/lote
OBS: NÃO UTILIZAR EM NOVAS INTEGRAÇÕES. PARA NOVAS INTEGRAÇÕES SEGUIR O LINK ABAIXO:
Manual de cadastro de produtos e Cenários (CFM)
Descrição dos campos de chamada:
| Campo | PAI | Descrição | Obrigatório |
| codigo_produto | carga_produto | Código do produto | Sim |
| ncm | carga_produto | Classificação fiscal do produto | Não |
| descricao | carga_produto | Descrição do produto | Não |
| orig | carga_produto | Origem do produto | Não |
|
ex_tipi |
carga_produto | Código EX da TIPI | Não |
|
cean |
carga_produto | Código de barras do produto | Não |
|
med_lista |
carga_produto | Utilizado apenas para medicamentos. Vide tabela abaixo | Não |
|
med_tipo |
carga_produto | Utilizado apenas para medicamentos. Vide tabela abaixo | Não |
|
complemento |
carga_produto | Complemento do produto | Não |
|
finalidade |
carga_produto | Código da finalidade do cenário | Não |
| acao | carga_produto | Ação (cadastrar ou desativar) | Não |
| username | / | Usuário do Cockpit | Não |
| senha | / | Senha do usuário | Não |
Tabela de referência para o campo "med_lista":
| Código | Descrição |
| 0 | Positiva |
| 1 | Negativa |
| 2 | Neutro |
Tabela de referência para o campo "med_tipo":
| Código | Descrição |
| R | Referência |
| G | Genérico |
| S | Similar |
| O | Outros |
Tabela de referência para o campo "acao":
| acao | Descrição |
| 1 | Cadastrar produto |
| 2 | Desativar produto |
Tabela de referência para os campos "origem" e "finalidade"
Acesse a última versão de documentação no link: Tabelas Auxiliares para obter os códigos de origem de materiais e finalidade.
Exemplos de chamada:
{
"carga_produtos": [
{
"acao": "1",
"codigo_produto": "código",
"orig": "0",
"ncm": "85365090",
"cean": "7898246050780",
"descricao": "descrição do produto"
},
{
"acao": "1",
"codigo_produto": "código",
"orig": "0",
"ncm": "85365090",
"cean": "7898246050780",
"descricao": "descrição do produto"
},
{
"acao": "1",
"codigo_produto": "código",
"orig": "0",
"ncm": "85365090",
"cean": "7898246050780",
"descricao": "descrição do produto"
},
{
"acao": "1",
"codigo_produto": "código",
"orig": "0",
"ncm": "85365090",
"cean": "7898246050780",
"descricao": "descrição do produto"
}
],
"username": "[email protected]",
"senha": "super123"
}
Descrição dos campos de retorno:
| Campo | PAI | Descrição |
| cpr_codi | / | Código interno da Systax |
| origem | / | Valor fixo "Systax" |
| sistema | / | Valor fixo "Cockpit" |
| cod_status | status | Código de retorno |
| msg_status | status | Mensagem de retorno |
Tabela de referência para os campos "cod_status" e "msg_status"
| cod_status | msg_status |
| 0 | Sucesso |
| 1 | LoginSenhaInvalido |
| 8 | UsuarioSemCliente |
| 9 | ClienteSemConnectionString |
| 10 | FalhaNaAplicacao |
| 13 | ParametrosInvalidos |
Exemplos de retorno:
{
"cpr_codi": [
57930
],
"origem": "Systax",
"sistema": "Cockpit",
"status": {
"cod_status": 0,
"msg_status": "Retorno com sucesso. "
}
}
Observação 1: A API suporta até 100 itens por requisição.
Observação 2: O produto demora em média 30 minutos para ser incluído no cadastro da Systax. Após esse tempo, será possível visualizar a carga do produto no Cockpit, porém, na tela de "Consulta de Produtos", o novo produto será visualizado somente após o processamento e entrega de alguma regra tributária associada á ele.