# API's

# API Leitura de regras

**Objetivo**: Retornar as regras aprovadas do Cockpit.

**Método**: POST

**API Rest / Json**: http://wscockpit.systax.com.br/api/api/regras

**OBS: NÃO UTILIZAR EM NOVAS INTEGRAÇÕES. PARA NOVAS INTEGRAÇÕES SEGUIR O LINK ABAIXO:**  
[Manual Cockpit API (Bearer)](https://documentacao.systax.com.br/books/manual-cockpit-api-bearer "Manual Cockpit API (Bearer)")

**Descrição dos campos de chamada:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td><td>**Obrigatório**</td></tr><tr><td>id\_cenario</td><td>/</td><td>Primeiro cenário a ser consultado. Pode ser informado 0 ou 1 para que a busca inicie pelo primeiro cenário disponível</td><td>Não</td></tr><tr><td>codigo\_produto</td><td>/</td><td>Código do produto a partir do qual se deseja realizar a leitura. Pode ser informado 0 ou 1 para iniciar pelo primeiro código disponível</td><td>Não</td></tr><tr><td>origem\_produto</td><td>/</td><td>Origem do material</td><td>Não</td></tr><tr><td>paginacao</td><td>/</td><td>Quantidade de registros exibidos por página com um limite de 100</td><td>Não</td></tr><tr><td>ponteiro\_atualizacao</td><td>/</td><td>Ponteiro do controle de atualização. Pode ser informado 0 ou 1 para exibir todas as regras</td><td>Não</td></tr><tr><td>username</td><td>/</td><td>Usuário do Cockpit</td><td>Não</td></tr><tr><td>senha</td><td>/</td><td>Senha do usuário</td><td>Não</td></tr></tbody></table>

**Campo "origem material":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-do-material-d"><tbody><tr><td>**Código do material**</td><td>**Descrição**</td></tr><tr><td>0</td><td>Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8</td></tr><tr><td>1</td><td>Estrangeira - Importação direta, exceto a indicada no código 6</td></tr><tr><td>2</td><td>Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7</td></tr><tr><td>3</td><td>Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%</td></tr><tr><td>4</td><td>Nacional, cuja produção tenha sido feita em conformidade com os PPB de que tratam as legislações citadas nos Ajustes</td></tr><tr><td>5</td><td>Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%</td></tr><tr><td>6</td><td>Estrangeira - Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural</td></tr><tr><td>7</td><td>Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista da CAMEX e gás natural</td></tr><tr><td>8</td><td>Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%</td></tr></tbody></table>

**Exemplos de chamada:**

{  
 "id\_cenario": "0",  
 "codigo\_produto": "0",  
 "origem\_produto": "0",  
 "paginacao": 100,  
 "ponteiro\_atualizacao": "0",  
 "username": "superdemo@systax.com.br",  
 "senha": "super123"  
}

**Descrição dos campos de retorno:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o--1"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td></tr><tr><td>ponteiro\_atualizacao</td><td>/</td><td>Ponteiro de atualização no formato ano+mês+dia+hora+minuto+segundo</td></tr><tr><td>origem</td><td>/</td><td>Valor fixo "Systax".</td></tr><tr><td>sistema</td><td>/</td><td>Valor fixo "Cockpit".

</td></tr><tr><td>cod\_status</td><td>status</td><td>Código de retorno</td></tr><tr><td>msg\_status</td><td>status</td><td>Mensagem de retorno</td></tr></tbody></table>

**Tabela de referência para os campos "cod\_status" e "msg\_status":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cod_status-msg_statu"><tbody><tr><td>**cod\_status**</td><td>**msg\_status**</td></tr><tr><td>0</td><td>Sucesso</td></tr><tr><td>1</td><td>LoginSenhaInvalido</td></tr><tr><td>8</td><td>UsuarioSemCliente</td></tr><tr><td>9</td><td>ClienteSemConnectionString</td></tr><tr><td>10</td><td>FalhaNaAplicacao</td></tr></tbody></table>

**Exemplos de retorno:**

{  
 "cenario": \[  
 {  
 "ent\_sai": "3",  
 "id\_cenario": "152275",  
 "apelido": "Revenda\_PR\_TO\_Importador\_CFC",  
 "uf\_origem": "PR",  
 "uf\_destino": "TO",  
 "origem": "24",  
 "destinacao": "3",  
 "cod\_natureza\_operacao": "712",  
 "retorno": \[  
 {  
 "cod\_prod": "100500",  
 "descricao": "ROLAMENTO - AGULHAS",  
 "ean": "00000000000000",  
 "ncm": "84824000",  
 "origem\_produto": "1",  
 "cfop": "6106",  
 "cest": "0104900",  
 "icms": {  
 "cst": "10",  
 "bc\_composicao": 1,  
 "bc\_composicao\_sn\_especial": 0,  
 "bc\_composicao\_fcp": 0,  
 "aliquota": "4.0000",  
 "generico": "tributos\_aproximados\_Estadual=18.00|tributos\_aproximados\_Federal=19.35",  
 "vigencia\_de": "2017-10-01T00:00:00",  
 "dispositivo\_legal": "Art. 8º, §2º, I, do RICMS/PR. Art. 18, III, do RICMS/PR.",  
 "inf\_adicionais": "Art. 61 e Item 11 do Anexo XXI do RICMS/TO. Art. 8º, §2º, I, do RICMS/PR. Art. 18, III, do RICMS/PR. Protocolo ICMS CONSELHO NACIONAL DE POLÍTICA FAZENDÁRIA - CONFAZ nº 97 de 09.07.2010",  
 "icms\_st": {  
 "bc\_composicao": 71,  
 "bc\_composicao\_fcp": 0,  
 "aliquota\_st": "18.0000",  
 "vigencia\_de": "2020-02-01T00:00:00",  
 "dispositivo\_legal": "Protocolo ICMS CONSELHO NACIONAL DE POLÍTICA FAZENDÁRIA - CONFAZ nº 97 de 09.07.2010. Art. 61 e Item 11 do Anexo XXI do RICMS/TO"  
 },  
 "estatistica": "A51"  
 },  
 "ipi": {  
 "cst": "50",  
 "cenq": "999",  
 "bc\_composicao": 57,  
 "aliquota": "12.0000",  
 "generico": "ipi\_cenq=999",  
 "vigencia\_de": "2017-03-09T00:00:00",  
 "dispositivo\_legal": "Art. 190 do RIPI/2010 e Decreto nº 8.950/2016"  
 },  
 "pis": {  
 "cst": "01",  
 "bc\_composicao": 2,  
 "aliquota": "1.6500",  
 "vigencia\_de": "2002-12-01T00:00:00",  
 "dispositivo\_legal": "Art. 1º da Lei nº 10.637/2002. Art. 2º, caput, da Lei nº 10.637/2002"  
 },  
 "cofins": {  
 "cst": "01",  
 "bc\_composicao": 2,  
 "aliquota": "7.6000",  
 "vigencia\_de": "2004-02-01T00:00:00",  
 "dispositivo\_legal": "Art. 1º da Lei nº 10.833/2003. Art. 2º, caput, da Lei nº 10.833/2003"  
 }  
 }  
 \]  
 }  
 \],  
 "ponteiro\_atualizacao": "20210514111645",  
 "origem": "Systax",  
 "sistema": "Cockpit",  
 "status": {  
 "cod\_status": 0,  
 "msg\_status": "Retorno com sucesso. "  
 }  
}

# API Cadastro de produtos

**Objetivo**: Cadastrar um único produto por requisição no Cockpit.

**Método**: POST

**API Rest / Json**: http://wscockpit.systax.com.br/api/api/carga\_produto

**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)](https://documentacao.systax.com.br/books/manual-de-cadastro-de-produtos-e-cenarios-cfm "Manual de cadastro de produtos e Cenários (CFM)")

**Descrição dos campos de chamada:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td><td>**Obrigatório**</td></tr><tr><td>codigo\_produto</td><td>carga\_produto</td><td>Código do produto</td><td>Sim</td></tr><tr><td>ncm</td><td>carga\_produto</td><td>Classificação fiscal do produto</td><td>Não</td></tr><tr><td>descricao</td><td>carga\_produto</td><td>Descrição do produto</td><td>Não</td></tr><tr><td>orig</td><td>carga\_produto</td><td>Origem do produto</td><td>Não</td></tr><tr><td>ex\_tipi

</td><td>carga\_produto</td><td>Código EX da TIPI</td><td>Não</td></tr><tr><td>cean

</td><td>carga\_produto</td><td>Código de barras do produto</td><td>Não</td></tr><tr><td>med\_lista

</td><td>carga\_produto</td><td>Utilizado apenas para medicamentos. Vide tabela abaixo</td><td>Não</td></tr><tr><td>med\_tipo

</td><td>carga\_produto</td><td>Utilizado apenas para medicamentos. Vide tabela abaixo</td><td>Não</td></tr><tr><td>complemento

</td><td>carga\_produto</td><td>Complemento da descrição do produto.</td><td>Não</td></tr><tr><td>finalidade

</td><td>carga\_produto</td><td>Não utilizar. Desenvolvido para difereciar a finalidade de cadastro do item. </td><td>Não</td></tr><tr><td>acao</td><td>carga\_produto</td><td>Ação (cadastrar ou desativar) </td><td>Não</td></tr><tr><td>username</td><td>/</td><td>Usuário do Cockpit</td><td>Não</td></tr><tr><td>senha</td><td>/</td><td>Senha do usuário</td><td>Não</td></tr></tbody></table>

**Tabela de referência para o campo "med\_lista":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-descri%C3%A7%C3%A3o-0-p"><tbody><tr><td>**Código**</td><td>**Descrição**</td></tr><tr><td>0</td><td>Positiva</td></tr><tr><td>1</td><td>Negativa</td></tr><tr><td>2</td><td>Neutro</td></tr></tbody></table>

**Tabela de referência para o campo "med\_tipo":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-descri%C3%A7%C3%A3o-r-r"><tbody><tr><td>**Código**</td><td>**Descrição**</td></tr><tr><td>R</td><td>Referência</td></tr><tr><td>G</td><td>Genérico</td></tr><tr><td>S</td><td>Similar</td></tr><tr><td>O</td><td>Outros</td></tr></tbody></table>

**Tabela de referência para o campo "acao":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-acao-descri%C3%A7%C3%A3o-1-cad"><tbody><tr><td>**acao**</td><td>**descrição**</td></tr><tr><td>1</td><td>Cadastrar produto</td></tr><tr><td>2</td><td>Desativar produto</td></tr></tbody></table>

**Tabela de referência para os campos "origem" e "finalidade"**

Acesse a última versão do documento no link: [Tabelas Auxiliares](https://documentacao.systax.com.br/books/tabelas-auxili "Tabelas Auxiliares") para obter os códigos de origem de materiais e finalidade.

**Exemplos de chamada:**

{  
 "carga\_produto": {  
 "codigo\_produto": "codigo",  
 "ncm": "02034044",  
 "descricao": "descricao do produto",   
 "orig": "0",  
 "acao": "1"  
},  
"username": "superdemo@systax.com.br",  
"senha": "super123"  
}

**Descrição dos campos de retorno:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o--1"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td></tr><tr><td>cpr\_codi</td><td>/</td><td>Código interno da Systax</td></tr><tr><td>origem</td><td>/</td><td>Valor fixo "Systax"</td></tr><tr><td>sistema</td><td>/</td><td>Valor fixo "Cockpit"</td></tr><tr><td>cod\_status</td><td>status</td><td>Código de retorno</td></tr><tr><td>msg\_status</td><td>status</td><td>Mensagem de retorno</td></tr></tbody></table>

**Tabela de referência para os campos "cod\_status" e "msg\_status"**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cod_status-msg_statu"><tbody><tr><td>**cod\_status**</td><td>**msg\_status**</td></tr><tr><td>0</td><td>Sucesso</td></tr><tr><td>1</td><td>LoginSenhaInvalido</td></tr><tr><td>8</td><td>UsuarioSemCliente</td></tr><tr><td>9</td><td>ClienteSemConnectionString</td></tr><tr><td>10</td><td>FalhaNaAplicacao</td></tr><tr><td>13</td><td>ParametrosInvalidos</td></tr></tbody></table>

**Exemplos de retorno:**

{  
 "cpr\_codi": 57929,  
 "origem": "Systax",  
 "sistema": "Cockpit",  
 "status": {  
 "cod\_status": 0,  
 "msg\_status": "Retorno com sucesso. "  
 }  
}

**Observação 1**: Essa API faz o cadastro de apenas 1 item por requisição. Caso haja a necessidade de cadastrar em lote, veja o tópico "API - Cadastro de produtos em Lote".

**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.

# API Associação de grupos/produtos

**Objetivos**: Associar um produto a um grupo de produtos, e também, pode ser utilizada para a criação de cenários.

**Comandos:** uma chamada pode resultar em até 4 ações sistêmicas:

1\) Associar o produto a grupo de produtos.

2\) Se o grupo não existir a API cria o grupo.

3\) Se o nome do grupo estiver no formato <u>ufOrigem - ufDestino - naturezaOp - perfilOrigem - perfilDestino - Finalidade</u> (que identifica um cenário) a API irá associar o grupo no cenário.

Exemplo: SP-SP-120-1-140-175. Obtenha os principais códigos e exemplos acessando o link: [Tabelas Auxiliares](https://documentacao.systax.com.br/books/tabelas-auxiliares "Tabelas Auxiliares")

**Importante**: O parâmetro "Finalidade" é obrigatório para cenários de entrada e não deve ser informado para cenários de saída.

4\) Se o cenário não existir com os parâmetros do item 3, a API irá criar o cenário.

**Grupo de Produtos - Conceito**

Este recurso é utilizado para limitar a produção de regras para um determinado cenário de forma que a Systax gere para o cliente apenas as regras que, de fato, ele utilizará, evitando o esforço e o custo do recebimento de dados desnecessários.

Em regra, nem todos os produtos do cliente são movimentados em todas as operações (geralmente isso ocorre nas compras), assim esse recurso permite a relação “N-N” entre produtos e cenários. Vejamos o exemplo abaixo de um cliente com 1.000 produtos cadastrados:

![](https://documentacao.systax.com.br/upload/20201026-22100657-602796976-4-Imagem_Exemplo%20Grupo%20de%20Produtos.png)

Internamente, o sistema terá a lista de produtos que compõem cada grupo (ex.: Comprados do AM: produtos “E” e “F”) e, sempre que um cenário estiver com um grupo associado (ex.: o Grupo de Produtos “Comprados do AM” estará associado ao cenário “Compra AM-SP”), somente serão geradas regras para os produtos movimentados nesta operação (ex.: para o cenário “Compra AM-SP” serão geradas regras apenas para os produtos “E” e “F”).

**Método:** POST

**API Rest / JSON**: http://wscockpit.systax.com.br/api/api/carga\_grupo\_produto

**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)](https://documentacao.systax.com.br/books/manual-de-cadastro-de-produtos-e-cenarios-cfm "Manual de cadastro de produtos e Cenários (CFM)")

**Descrição dos campos de chamada:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td><td>**Obrigatório**</td></tr><tr><td>codigo\_produto</td><td>carga\_grupo\_produto</td><td>Código do produto</td><td>Sim</td></tr><tr><td>origem\_produto</td><td>carga\_grupo\_produto</td><td>Origem do produto</td><td>Não</td></tr><tr><td>grupo</td><td>carga\_grupo\_produto</td><td>Código do grupo de produtos</td><td>Não</td></tr><tr><td>acao</td><td>carga\_grupo\_produto</td><td>Ação (cadastrar ou desativar)</td><td>Não</td></tr><tr><td>username</td><td>/</td><td>Usuário do Cockpit</td><td>Não</td></tr><tr><td>senha</td><td>/</td><td>Senha do usuário</td><td>Não</td></tr></tbody></table>

**Tabela de referência para o campo "origem\_produto":**

Acesse o link : [Tabelas Auxiliares](https://documentacao.systax.com.br/books/tabelas-auxiliares "Tabelas Auxiliares") para obter a tabela de origem de materiais.

**Tabela de referência para o campo "acao":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-acao-descri%C3%A7%C3%A3o-1-cad"><tbody><tr><td>**acao**</td><td>**descrição**</td></tr><tr><td>1</td><td>Cadastrar produto</td></tr><tr><td>2</td><td>Desativar produto</td></tr></tbody></table>

**Exemplos de chamada:**

{  
 "carga\_grupo\_produto": {  
 "codigo\_produto": "codigo",  
 "origem\_produto": 0,  
 "grupo": "nome do grupo",  
 "acao": 1  
 },  
 "username": "superdemo@systax.com.br",  
 "senha": "super123"  
}

**Descrição dos campos de retorno:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o--1"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td></tr><tr><td>origem</td><td>/</td><td>Valor fixo "Systax"</td></tr><tr><td>sistema</td><td>/</td><td>Valor fixo "Cockpit"</td></tr><tr><td>cod\_status</td><td>status</td><td>Código de retorno</td></tr><tr><td>msg\_status</td><td>status</td><td>Código de retorno</td></tr></tbody></table>

**Tabela de referência para os campos "cod\_status" e "msg\_status"**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cod_status-msg_statu"><tbody><tr><td>**cod\_status**</td><td>**msg\_status**</td></tr><tr><td>0</td><td>Sucesso</td></tr><tr><td>1</td><td>LoginSenhaInvalido</td></tr><tr><td>8</td><td>UsuarioSemCliente</td></tr><tr><td>9</td><td>ClienteSemConnectionString</td></tr><tr><td>10</td><td>FalhaNaAplicacao</td></tr></tbody></table>

**Exemplos de retorno:**

{  
 "origem": "Systax",  
 "sistema": "Cockpit",  
 "status": {  
 "cod\_status": 0,  
 "msg\_status": "Retorno com sucesso. "  
 }  
}

# 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)](https://documentacao.systax.com.br/books/manual-de-cadastro-de-produtos-e-cenarios-cfm "Manual de cadastro de produtos e Cenários (CFM)")

**Descrição dos campos de chamada:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o-"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td><td>**Obrigatório**</td></tr><tr><td>codigo\_produto</td><td>carga\_produto</td><td>Código do produto</td><td>Sim</td></tr><tr><td>ncm</td><td>carga\_produto</td><td>Classificação fiscal do produto</td><td>Não</td></tr><tr><td>descricao</td><td>carga\_produto</td><td>Descrição do produto</td><td>Não</td></tr><tr><td>orig</td><td>carga\_produto</td><td>Origem do produto</td><td>Não</td></tr><tr><td>ex\_tipi

</td><td>carga\_produto</td><td>Código EX da TIPI</td><td>Não</td></tr><tr><td>cean

</td><td>carga\_produto</td><td>Código de barras do produto</td><td>Não</td></tr><tr><td>med\_lista

</td><td>carga\_produto</td><td>Utilizado apenas para medicamentos. Vide tabela abaixo</td><td>Não</td></tr><tr><td>med\_tipo

</td><td>carga\_produto</td><td>Utilizado apenas para medicamentos. Vide tabela abaixo</td><td>Não</td></tr><tr><td>complemento

</td><td>carga\_produto</td><td>Complemento do produto</td><td>Não</td></tr><tr><td>finalidade

</td><td>carga\_produto</td><td>Código da finalidade do cenário</td><td>Não</td></tr><tr><td>acao</td><td>carga\_produto</td><td>Ação (cadastrar ou desativar) </td><td>Não</td></tr><tr><td>username</td><td>/</td><td>Usuário do Cockpit</td><td>Não</td></tr><tr><td>senha</td><td>/</td><td>Senha do usuário</td><td>Não</td></tr></tbody></table>

**Tabela de referência para o campo "med\_lista":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-descri%C3%A7%C3%A3o-0-p"><tbody><tr><td>**Código**</td><td>**Descrição**</td></tr><tr><td>0</td><td>Positiva</td></tr><tr><td>1</td><td>Negativa</td></tr><tr><td>2</td><td>Neutro</td></tr></tbody></table>

**Tabela de referência para o campo "med\_tipo":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-c%C3%B3digo-descri%C3%A7%C3%A3o-r-r"><tbody><tr><td>**Código**</td><td>**Descrição**</td></tr><tr><td>R</td><td>Referência</td></tr><tr><td>G</td><td>Genérico</td></tr><tr><td>S</td><td>Similar</td></tr><tr><td>O</td><td>Outros</td></tr></tbody></table>

**Tabela de referência para o campo "acao":**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-acao-descri%C3%A7%C3%A3o-1-cad"><tbody><tr><td>**acao**</td><td>**Descrição**</td></tr><tr><td>1</td><td>Cadastrar produto</td></tr><tr><td>2</td><td>Desativar produto</td></tr></tbody></table>

**Tabela de referência para os campos "origem" e "finalidade"**

Acesse a última versão de documentação no link: [Tabelas Auxiliares](https://documentacao.systax.com.br/books/tabelas-auxiliares "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": "superdemo@systax.com.br",  
 "senha": "super123"  
}

**Descrição dos campos de retorno:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-pai-descri%C3%A7%C3%A3o--1"><tbody><tr><td>**Campo**</td><td>**PAI**</td><td>**Descrição**</td></tr><tr><td>cpr\_codi</td><td>/</td><td>Código interno da Systax</td></tr><tr><td>origem</td><td>/</td><td>Valor fixo "Systax"</td></tr><tr><td>sistema</td><td>/</td><td>Valor fixo "Cockpit"</td></tr><tr><td>cod\_status</td><td>status</td><td>Código de retorno</td></tr><tr><td>msg\_status</td><td>status</td><td>Mensagem de retorno</td></tr></tbody></table>

**Tabela de referência para os campos "cod\_status" e "msg\_status"**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cod_status-msg_statu"><tbody><tr><td>**cod\_status**</td><td>**msg\_status**</td></tr><tr><td>0</td><td>Sucesso</td></tr><tr><td>1</td><td>LoginSenhaInvalido</td></tr><tr><td>8</td><td>UsuarioSemCliente</td></tr><tr><td>9</td><td>ClienteSemConnectionString</td></tr><tr><td>10</td><td>FalhaNaAplicacao</td></tr><tr><td>13</td><td>ParametrosInvalidos</td></tr></tbody></table>

**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.