# Capítulo IX - Cadastro de cenários Cadastrar um ou mais cenários (operações do cliente) em uma mesma requisição. **ATENÇÃO:** Antes de iniciar o cadastro de cenários, leia atentamente o nosso "Roteiro de cenários", disponível no link: [https://documentacao.systax.com.br/books/manual-para-criacao-de-cenarios](https://documentacao.systax.com.br/books/roteiro-para-criacao-de-cenarios). A criação de cenário com parâmetros errados, gerará retorno tributário errado para todos os itens do cenário incorreto. Caso tenha necessidade de alterar algum cenário cadastrado com erro, será preciso deletá-lo e cadastrar um novo correto ou acionar o nosso time e solicitar o ajuste. # Descrição dos campos de entrada e retorno
**Campo** **PAI** **Descrição**
id cenarios Não enviar esta tag. Este código será gerado e preenchido automaticamente pelo sistema Systax.
id\_cliente cenarios ID do cliente
grupo\_cache cenarios Preencher sempre com "A"
apelido cenarios Descrição do cenário
ent\_sai cenarios Tipo entrada/saída
cod\_nat\_op cenarios Código de natureza de operação
finalidade cenarios Código de finalidade
destinacao cenarios Perfil do destinatário
alternativo\_ex\_origem cenarios Perfil do remetente
uf\_origem cenarios UF do remetente
uf\_destino cenarios UF do destinatário
id\_mun\_origem cenarios Código IBGE do município do remetente - Preencher somente para municípios com tributação diferenciada (ex.: municípios localizados na ZFM e ALC).
id\_mun\_destino cenarios Código IBGE do município do destinatário - Preencher somente para municípios com tributação diferenciada (ex.: municípios localizados na ZFM e ALC).
cnpj\_ex\_origem cenarios CNPJ do remetente - Preencher somente se houver orientação específica do time Systax.
cnae\_destinatario cenarios CNAE do destinatário - Preencher somente para casos de tributação por CNAE (ex.: operações com destino a MT ou CE).
origem\_produto\_alternativo cenarios Preencher somente se houver orientação específica do time Systax.
cenario\_ind\_prod cenarios Uso interno Systax. Não preencher.
st\_cest cenarios Uso interno Systax. Não preencher.
frequencia cenarios Preenchimento padrão: "1" - Para cenários de Saída "2" - Para cenários de Entrada
dias\_futuros cenarios Prenchimento padrão: "30". Refere-se à vigência da regra entregue.
dt\_criacao cenarios Não enviar esta tag. A data será preenchida automaticamente pelo sistema Systax.
grupos cenarios Preencher a tag, somente quando houver precisra incluir o cenário em um grupo de produtos. Para mais de um grupo, separar por virgula, conforme exemplo abaixo. “grupos”: ”Teste1,Teste2,Teste3”
***IMPORTANTE:** para os campos em que não for necessário o preenchimento, não enviar a tag ou enviar sem preenchimento.* **Tabela de referência para o campo "ent\_sai":**
**ent\_sai** **Descrição**
1 Entrada
3 Saída
**Tabela de referência para os campos "cod\_nat\_op", "finalidade", "destinacao" e "alternativo\_ex\_origem":** Para obter a tabela com os principais códigos dos campos acima, acesse a última versão de documentação no link: [https://documentacao.systax.com.br/PublicView2/Index/c14f5c52f0b52073cdf05eb75/26445](https://documentacao.systax.com.br/PublicView2/Index/c14f5c52f0b52073cdf05eb75/26445). Caso tenha alguma situação específica e não localize nas tabelas um código compatível com a necessidade, acione nosso time para que possamos lhe dar orientações assertivas. **Descrição dos campos de retorno**
**Campo** **PAI** **Descrição**
success / Status do retorno
message / Mensagem do retorno
total\_itens / Quantidade de cenários na chamada
total\_ok / Quantidade de cenários cadastrados
position itens\_ok Posição do cenário na chamada
id itens\_ok ID do cenário cadastrado
total\_error / Quantidade de cenários não cadastrados
position itens\_error Posição do cenário na chamada
message itens\_error Mensagem do retorno
**Tabela de referência para os campos "success" e "message"**
**Código de retorno** **success** **message**
200 true OK
400 false false token\_invalid token\_expired
500 false internal\_error
# Exemplo de chamada e retorno **Chamada** { "cenarios": \[ { "id\_cliente": "71408", "grupo\_cache": "A", "apelido": "Compra Ind\_varejo\_MG\_SP", "ent\_sai": "3", "cod\_nat\_op": "121", "finalidade": "", "destinacao": "2", "alternativo\_ex\_origem": "1", "uf\_origem": "AC", "uf\_destino": "AC", "id\_mun\_origem": "", "id\_mun\_destino": "", "cnpj\_ex\_origem": "", "cnae\_destinatario": "", "origem\_produto\_alternativo": "", "cenario\_ind\_prod": "", "st\_cest": "", "frequencia": "1", "dias\_futuros": "30", "grupos": "" } \] } **Retorno** { "success": true, "message": "ok", "total\_itens": 2, "total\_ok": 2, "itens\_ok": \[ { "position": 0, "id": "2033763" }, { "position": 1, "id": "2033764" } \], "total\_error": 0, "itens\_error": \[\] }