# Chamada e retorno

Detalhamento dos campos da chamada e retorno da API.

# Descrição dos campos de chamada e retorno

Descrição dos campos de chamada:

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-descri%C3%A7%C3%A3o-user"><tbody><tr><td>**Campo**</td><td>**Descrição**</td></tr><tr><td>username</td><td>Usuário cadastrado no site Systax e serviço de parametrização fiscal </td></tr><tr><td>senha</td><td>Senha do usuário cadastrado no site Systax e serviço de parametrização fiscal </td></tr></tbody></table>

Descrição dos campos de retorno:

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-campo-descri%C3%A7%C3%A3o-cod_"><tbody><tr><td>**Campo**</td><td>**Descrição**</td></tr><tr><td>cod\_status</td><td>Código de retorno (vide tabela abaixo)</td></tr><tr><td>msg\_status</td><td>Mensagem do código de retorno (vide tabela abaixo)</td></tr><tr><td>cenario</td><td>XML com lista de cenários</td></tr></tbody></table>

Lista de códigos e mensagens de retorno:

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cod_status%C2%A0-msg_stat"><tbody><tr><td>**cod\_status** </td><td>**msg\_status** </td></tr><tr><td>0</td><td>Retorno com sucesso</td></tr><tr><td>1</td><td>Login ou senha inválida</td></tr><tr><td>4</td><td>Seu período de acesso expirou em \[DATA\_EXP\]</td></tr><tr><td>5</td><td>Crédito insuficiente, seu saldo é \[SALDO\]</td></tr><tr><td>6</td><td>Código NCM não localizado na tabela ou não teve atualizações</td></tr></tbody></table>

# Exemplo de chamada

&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:systax\_erp\_cenario"&gt;  
 &lt;soapenv:Header/&gt;  
 &lt;soapenv:Body&gt;  
 &lt;urn:systax\_erp\_cenario&gt;  
 &lt;username&gt; **usuário**&lt;/username&gt;  
 &lt;senha&gt;**senha**&lt;/senha&gt;  
 &lt;/urn:systax\_erp\_cenario&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;

# Exemplos de retorno

&lt;SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="urn:systax\_erp\_cenario"&gt;  
 &lt;SOAP-ENV:Body&gt;  
 &lt;ns1:systax\_erp\_cenarioResponse xmlns:ns1="urn:systax\_erp\_cenario"&gt;  
 &lt;body xsi:type="tns:systax\_ret"&gt;  
 &lt;origem&gt;Systax&lt;/origem&gt;  
 &lt;sistema&gt;ERP - Cen&amp;amp;aacute;rios&lt;/sistema&gt;  
 &lt;status&gt;  
 &lt;cod\_status&gt;0&lt;/cod\_status&gt;  
 &lt;msg\_status&gt;Retorno com sucesso.&lt;/msg\_status&gt;  
 &lt;/status&gt;  
 &lt;cenario&gt;&lt;!\[CDATA\[  
 &lt;?xml version="1.0"?&gt;  
 &lt;cenario&gt;  
 &lt;retorno&gt;  
 &lt;id\_cenario&gt;1443506&lt;/id\_cenario&gt;  
 &lt;descricao&gt;Compra-CE-DF-Importador-Varejo&lt;/descricao&gt;  
 &lt;uf\_origem&gt;CE&lt;/uf\_origem&gt;  
 &lt;uf\_destino&gt;DF&lt;/uf\_destino&gt;  
 &lt;grupo&gt;CE-DF-121-24-140&lt;/grupo&gt;  
 &lt;dias\_futuros&gt;30&lt;/dias\_futuros&gt;  
 &lt;ent\_sai&gt;1&lt;/ent\_sai&gt;  
 &lt;finalidade&gt;569&lt;/finalidade&gt;  
 &lt;cod\_nat\_op&gt;121&lt;/cod\_nat\_op&gt;  
 &lt;origem&gt;24&lt;/origem&gt;  
 &lt;destinacao&gt;140&lt;/destinacao&gt;  
 &lt;/retorno&gt;  
 &lt;retorno&gt;  
 &lt;id\_cenario&gt;1442591&lt;/id\_cenario&gt;  
 &lt;descricao&gt;Compra-RJ-DF-importador-Varejo&lt;/descricao&gt;  
 &lt;uf\_origem&gt;RJ&lt;/uf\_origem&gt;  
 &lt;uf\_destino&gt;DF&lt;/uf\_destino&gt;  
 &lt;grupo&gt;RJ-DF-121-24,828-140&lt;/grupo&gt;  
 &lt;dias\_futuros&gt;30&lt;/dias\_futuros&gt;  
 &lt;ent\_sai&gt;1&lt;/ent\_sai&gt;  
 &lt;finalidade&gt;569&lt;/finalidade&gt;  
 &lt;cod\_nat\_op&gt;121&lt;/cod\_nat\_op&gt;  
 &lt;origem&gt;24,828&lt;/origem&gt;  
 &lt;destinacao&gt;140&lt;/destinacao&gt;  
 &lt;/retorno&gt;  
 &lt;/cenario&gt;   
 &lt;/body&gt;  
 &lt;/ns1:systax\_erp\_cenarioResponse&gt;  
 &lt;/SOAP-ENV:Body&gt;  
&lt;/SOAP-ENV:Envelope&gt;