Escolar Documentos
Profissional Documentos
Cultura Documentos
1. INTRODUÇÃO
Este documento especifica o padrão que deve ser seguido para a realização de integrações de softwares terceiros
com o CISSPoder.
2. ARQUITETURA DO SERVIÇO
A API INTEGRIM foi criada para facilitar de forma segura a integração dos dados CISSPODER com software de
terceiros. É necessário que o cliente (terceiros) desenvolvam de forma a consumir a API INTEGRIM.
Na imagem a baixo é possível entender como deve ser feito a integração de forma macro.
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 1/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
3. FERRAMENTAS
Para que seja possível a integração com o CISSPoder deve-se fazer uso das ferramentas CISSPoder Auth e Integrim,
sendo assim possível obter o “token” de autenticação e fazer uso dos serviços disponibilizados.
4. INSTALAÇÃO
A instalação do CISSPoder Auth e Integrim é realizada através do CIM - CISS INSTALLATION MANAGEMENT.
Acessar o CIM Client na sua máquina e na opção Todos pesquisar por CISSPoderAuth e clicar em Mais Detalhes do
aplicativo:
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 2/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 3/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Após instalação do CISSPoderAuth será necessário realizar a instalação do Integrim. Para isso, pesquisar no CIM e
clicar em Mais Detalhes do aplicativo:
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 4/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 5/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
5. COMO UTILIZAR
Neste item apresentamos um exemplo de como consumir um serviço de integração CISSPoder através da ferramenta
POSTMAN, a requisição é feita via protocolo HTTP e o retorno em arquivo extensão JSON.
5.1. Pré-Requisitos
Para que seja possível a utilização dos serviços de integração CISSPoder se faz obrigatória a instalação dos
aplicativos CISSPoderAuth e Integrim.
A aplicação pode ser facilmente instalada como uma extensão do browserGoogle Chrome.
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 6/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Para que os serviços de integração CISSPoder possam retornar os dados solicitados, antes da requisição é
necessário obter o “token” de autorização via CISSPoderAuth. Segue um exemplo se requisição de “token” através da
ferramenta POSTMAN. Para correta configuração basta realizar os passos de 01 a 11 conforme imagens 01 e 02.
5.3.6. Para as configurações da imagem 11 deve-se selecionar a aba“Body” (Item 06 da imagem 12).
5.3.7. Deve ser selecionado a opção “x-www-from-urlencoded” (Item 07 da imagem 12).
5.3.8. Devem ser informadas as cinco configurações de chave e valor, abaixo a definição de cada uma delas (Item 08
imagem 12):
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 7/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Atenção: Username e Password são usuários do CISSPODER, é necessário solicitar ao cliente para que crie um
usuário especifico e com senha segura.
5.3.9. Depois de realizadas as configurações clicar no botão “SEND” para gerar o “token” (Item 09 da imagem 12).
5.3.10. Neste passo podemos visualizar o “token” gerado (Item 10 da imagem 12).
5.3.11. Cada “token” gerado tem validade de 24 horas, caso seja necessária à atualização dele basta clicar
novamente no botão “SEND”(Passo 09) e a atualização será gerada (Item 11 da imagem 12).
Com as configurações para obter o “token” já realizadas, agora podemos configurar o POSTMAN para fazer a
requisição aos serviços de integração CISSPoder. Neste exemplo mostramos como requisitar dados ao serviço
“cad_pessoas” nos passos de 01 a 09 como mostram as imagens 12 e 13:
Passo 01 - Apresentada uma nova aba na aplicação POSTMAN, selecionamos a opção “POST” como forma de
requisição (Número 01 da imagem 12).
Passo 02 - Agora deve-se informar o endereço da rede local referente a a aplicação CISS Integrim,
responsável pelas integrações CISSPoder (Número 02 da imagem 12).
Passo 03 - Neste passo deve-se selecionar a aba “Headers” para realizar asconfigurações do passo seguinte
(Número 03 da imagem 12)
Passo 04 - Informar as configurações de chave e valor conforme definição abaixo (Número 04 da imagem 12):
Passo 05 - Agora selecionando a aba “body” podemos adicionar filtros e ordenações para o retorno dos dados
dos serviços CISSPoder (Número 05 da imagem 13).
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 8/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Passo 06 - Para que a configuração de filtros e ordenações seja possível deve-se selecionar a opção “raw”
(Número 06 da imagem 13).
Passo 07 – Neste passo é possível filtrar os dados que serão retornados dos serviços de integração
CISSPoder, para isso, basta seguir a linguagem apresentada na imagem.
No exemplo apresentado os dados são filtrados para que o retorno seja equivalente ao “idclifor = 1” através da seção
“clausulas”.Desta forma pode-se filtrar o retorno por qualquer coluna presente no serviço,utilizando o nome dela, a
qual está presente no item DETALHAMENTO DE SERVIÇOS deste documento (Número 07 da imagem 13).
Para realizar a ordenação dos dados retornados, deve-se fazer uso da seção “ordenacoes” informando pela qual
coluna é desejada a ordenação, no exemplo os dados são ordenados pela coluna “idclifor” de forma ascendente
(Número 07 da imagem 13).
Passo 08 - Após realizadas as devidas configurações de filtros e ordenações basta clicar no botão “SEND” para
que os dados sejam retornados (Número 08da imagem 13).
Passo 09 - Os dados serão apresentados em formato “JSON” na aba “body”(Número 09 da imagem 13).
OperadoresPara realização das requisições, os seguintes operadores podem ser utilizadosnas clausulas:
IGUAL("=", "==");
IGUAL_NULL("is null", "is null");
EQUAL("=", "eq");
MENOR("<", "lt");
MAIOR(">", "gt");
LIKE("like", "like");
MENOR_IGUAL("<=", "lte");
MAIOR_IGUAL(">=", "gte"),
BETWEEN("between", "bt");
6 - EXEMPLO DE REQUISIÇÃO
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 10/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
O retorno da requisição é paginado, contendo 1000 registros por página, caso na requisição não seja indicado a
página que deseja listar será apresentado os dados da pagina 1.Para identificar a quantidade de registros observar no
retorno o campo “Total”que virá com a quantidade total de registros retornados na consulta, incluindo a página
apresentada e se há mais páginas a listar o campo "hasNext" virá como True(Imagem 19).
7. SERVIÇOS DISPONÍVEIS
A lista de serviços está disponível no relatório 854 do CISSPODER (link para download
(https://drive.google.com/file/d/13lcz4UEoow_d_SqpHTAI4DMB-2D_O3-z/view?usp=sharing)). O Relatório foi criado pois
cada cliente pode ter serviços específicos que não vão estar relacionados nesse manual.
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 12/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 13/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 14/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
CAD_LOJAS
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador IDEMPRESA Número Inteiro 08
Nome Fantasia NOMEFANTASIA Texto 60
Razão Social RAZAOSOCIAL Texto 60
CNPJ CNPJ Texto 14
Inscrição Municipal INSCRMUNICIPAL Texto 20
Inscrição Estadual INSCRESTADUAL Texto 16
Endereço ENDERECO Texto 60
Número NUMERO Texto 10
Bairro BAIRRO Texto 20
Cidade DESCRCIDADE Texto 200
Sigla da unidade de federação,
Estado UF Texto 02
estado.
CEP IDCEP Número Inteiro 08
Complemento COMPLEMENTO Texto 80
Telefone FONE Texto 20
Fax FONEFAX Texto 20
E-mail EMAIL Texto 40
Administrador NOMEADMINISTRADOR Texto 30
Contador NOMECONTADOR Texto 30
"R" - Lucro real,
Regime Federal TIPOREGIMEFEDERAL Texto 01 "P" - Lucro presumido, "S" - Simples
Federal.
Data de Alteração DTALTERACAO Data
CAD_PESSOAS
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador IDCLIFOR Número Inteiro 08
Tipo Pessoa TIPOFISICAJURIDICA Texto 01 "F" - Física, "J" - Jurídica
"C" - Cliente, "A" - Cliente /
Fornecedor, "U" - Colaborador, "F" -
Fornecedor, "M" - Motorista, "O" -
Tipo Cadastro TIPOCADASTRO Texto 01
Produtivo, "P" - Prospect, "R" -
Revenda, "T" - Transportador, "V" -
Vendedor
Status FLAGINATIVO Texto 01 "F" - Ativo, "T" - Inativo
Nome / Razao
NOME Texto 80
Social
Nome Fantasia NOMEFANTASIA Texto 80
CPF/ CNPJ CNPJCPF Texto 14
RG RG Texto 15
Orgão Emissor RG EMISSORRG Texto 10
"A" - Amasiado, "C" - Casado, "D" -
Estado Civil TIPOESTADOCIVIL Texto 01 Divorciado, "S" - Solteiro, "V" -
Viúvo.
Data de Nascimento DTNASCIMENTO Data 10
Data de Cadastro DTCADASTRO Data 10
Endereço ENDERECO Texto 80
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 15/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
CAD_PRODUTOS
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador 01 IDPRODUTO Número Inteiro 08 Código do Produto
Código Identificador 02 IDSUBPRODUTO Número Inteiro 08 Código do Sub Produto
Descrição Principal DESCRCOMPRODUTO Texto 60
Descrição Resumida DESCRRESPRODUTO Texto 40
Sub Descrição SUBDESCRICAO Texto 100
Código de Barras NRCODBARPROD Decimal 14,0
Código de Barras da
IDCODBARCX Decimal 14,0
Caixa
Código da Divisão IDDIVISAO Número Inteiro 08 Estrutura mercadológica
Descrição da Divisão DESCRDIVISAO Texto 40 Estrutura mercadológica
Código da Seção IDSECAO Número Inteiro 08 Estrutura mercadológica
Descrição da Seção DESCRSECAO Texto 40 Estrutura mercadológica
Código Do Grupo IDGRUPO Número Inteiro 08 Estrutura mercadológica
Descrição Do Grupo DESCRGRUPO Texto 40 Estrutura mercadológica
Código do Subgrupo IDSUBGRUPO Número Inteiro 08 Estrutura mercadológica
Descrição Do
DESCRSUBGRUPO Texto 40 Estrutura mercadológica
Subgrupo
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 16/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
DOCUMENTOS_FISCAIS_ENTRADA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
Código Identificador de Número
IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDCLIFOR 08
Fornecedor Inteiro
Nome \ Razão Social do
NOME Texto 80
Fornecedor
Número
Número do Documento Fiscal NUMNOTA 04
Inteiro
Série SERIENOTA Texto 03
Modelo MODELO Texto 03
Estado de Origem UF Texto 02
Valor Total VALCONTABIL Decimal 14,2
Valor de Impostos Não
VALIMPOSTOS Decimal 15,6 IPI + PIS + COFINS + ICMS
Recuperáveis
Valor de Desconto VALDESCONTOFINANCEIRO Decimal 15,6
Valor de Acréscimo VALACRESCIMOFINANCEIRO Decimal 15,6
Valor do Frete VALFRETENOTA Decimal 14,2
Data de Emissão DTEMISSAO Data
Data de Movimento DTMOVIMENTO Data/Hora
Chave Eletrônica CHAVENFE Texto 44
Tipo TIPONOTA Texto 01 "E" - Entrada, "D" - Devolução.
Data de Alteração DTALTERACAO Data
Cadastro do CNPJ (Cadastro
nacional de pessoa juridica,
CNPJCPF Texto 14
antigo CGC) ou CPF do
cadastrado
DOCUMENTOS_FISCAIS_SAÍDA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 17/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
ITENS_DOCUMENTOS_FISCAIS_ENTRADA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
Código Identificador do Número
IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDVENDEDOR 04
Vendedor Inteiro
Número
Código Identificador Item 01 IDPRODUTO 08 Código do Produto
Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 18/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Número
Código Identificador Item 02 IDSUBPRODUTO 08 Código do Sub Produto
Inteiro
Número de sequência do item Número
NUMSEQUENCIA 04
na gravação Inteiro
Valor de Desconto do Item VALDESCONTOPRO Decimal 15,6
Valor de Acréscimo do Item VALACRESCIMOPRO Decimal 15,6
Valor de Impostos não
VALIMPOSTOS Decimal 15,6 IPI + PIS + COFINS + ICMS
Recuperáveis
Valor de Frete do Item VALFRETE Decimal 15,6
Quantidade QTDPRODUTO Decimal 12,3
Valor Unitário Bruto VALUNITBRUTO Decimal 15,6
Valor Unitário Líquido VALTOTLIQUIDO Decimal 15,6
Data de Movimento DTMOVIMENTO Data
Código de identificação da Número
CFOP 04
operação fiscal Inteiro
ITENS_DOCUMENTOS_FISCAIS_SAIDA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
Código Identificador do Número
IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDVENDEDOR 04
Vendedor Inteiro
Número
Código Identificador Item 01 IDPRODUTO 08 Código do Produto
Inteiro
Número
Código Identificador Item 02 IDSUBPRODUTO 08 Código do Sub Produto
Inteiro
Número de sequência do item Número
NUMSEQUENCIA 04
na gravação Inteiro
Valor de Desconto do Item VALDESCONTOPRO Decimal 15,6
Valor de Acréscimo do Item VALACRESCIMOPRO Decimal 15,6
Valor de Impostos não
VALIMPOSTOS Decimal 15,6 IPI + PIS + COFINS + ICMS
Recuperáveis
Valor de Frete do Item VALFRETE Decimal 15,6
Quantidade QTDPRODUTO Decimal 12,3
Valor Unitário Bruto VALUNITBRUTO Decimal 15,6
Valor Unitário Líquido VALTOTLIQUIDO Decimal 15,6
Data de Movimento DTMOVIMENTO Data
Descrição resumida do
DESCRPRODUTO Texto 40
produto
Código de identificação da Número
CFOP 04
operação fiscal Inteiro
RECEBIMENTOS_DOCUMENTOS_FISCAIS_SAIDA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
Código Identificador do Número
IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDCLIFOR 08
Cliente Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 19/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
PAGAMENTOS_DOCUMENTOS_FISCAIS_ENTRADA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
Código Identificador do Número
IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDCLIFOR 08
Cliente Inteiro
Série da nota fiscal a qual se
SERIENOTA Texto 03
refere o título
Código Identificador da Número
IDTITULO 04
Duplicata Inteiro
Código Identificador da Forma Número
IDRECEBIMENTO 04
de Pagamento Inteiro
Descrição da Forma de
DESCRRECEBIMENTO Texto 40
Pagamento
Número da Parcela DIGITOTITULO Texto 02
Valor da Parcela VALTITULO Decimal 14,2
Valor total pago da parcela VALTITULOPAGO Decimal 14,2
Valor total pendente da
VALTITULOPENDENTE Decimal 14,02
parcela
Valor de Descontos VALDESCCONCEDIDOTITULO Decimal 14,2
Valor de Juros VALJUROSCOBRADO Decimal 14,2
Data de Vencimento DTVENCIMENTO Date
Data do Último Recebimento DTULTIMOPAGAMENTO Date
Data de lançamento do título DTMOVIMENTO Date
Observação sobre o título OBSTITULO Texto 600
PRECOS_CUSTOS_PRODUTOS_EMPRESA
Informação Nome Técnico Tipo Tamanho Definições
Número
Código Identificador de Loja IDEMPRESA 08
Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 20/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Número
Código Identificador Item 01 IDPRODUTO 08 Código do Produto
Inteiro
Número
Código Identificador Item 02 IDSUBPRODUTO 08 Código do Sub Produto
Inteiro
Valor de Preço Varejo VALPRECOVAREJO Decimal 15,6
Valor de Preço Varejo
VALPROMVAREJO Decimal 15,6
Promoção
Data Início Promoção Varejo DTINIPROMOCAOVAR Data
Data Fim Promoção Varejo DTFIMPROMOCAOVAR Data
Valor de Preço Atacado VALPRECOATACADO Decimal 15,6
Valor de Preço Atacado
VALPROMATACADO Decimal 15,6
Promoção
Data Início Promoção Atacado DTINIPROMOCAOATAC Data
Data Fim Promoção Atacado DTFIMPROMOCAOATAC Data
Valor de Custo Reposição VALCUSTOREPOS Decimal 15,6
Valor de Custo Gerencial CUSTOGERENCIAL Decimal 15,6
Valor de Custo Nota Fiscal CUSTONOTAFISCAL Decimal 15,6
Data de Alteração Preço
DTALTERACAOVAR Data
Varejo
Data de Alteração Preço
DTALTERACAOPROMOVAR Data
Varejo Promoção
Data de Alteração Preço
DTALTERACAOATAC Data
Atacado
Data de Alteração Preço
DTALTERACAOPROMOATAC Data
Atacado Promoção
PRECOS_POR_CLIENTE
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IDPROMOCAO 08
Promoção Inteiro
Descrição da Promoção DESCRPROMOCAO Texto 40
Número
Código Identificador de Item IDSUBPRODUTO 08 Código do Sub Produto
Inteiro
Descrição Resumida DESCRRRESPRODUTO Texto 40
"F" - Preço Fixo , "V" - %
Tipo da Promoção TIPOPROMOCAO Texto 01
Sobre o Preço Atual
Preço de Atacado VALPRECOATACADO Decimal 15,6
Preço de Varejo VALPRECOVAREJO Decimal 15,6
% Sobre Atacado PERMARGEMATACADO Decimal 10,2
% Sobre Varejo PERMARGEMVAREJO Decimal 10,2
Número
Código Identificador do Cliente IDCLIFOR 08
Inteiro
Nome Cliente NOME Texto 80
Data Inicial da Promoção DTINICIALPROMOCAO Data
Data Final da Promoção DTFINALPROMOCAO Data
CONDICOES_FORMA_PAGAMENTO_RECEBIMENTO
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da forma Número
IDRECEBIMENTO 04
de pagamento/recebimento Inteiro
Código identificador da Número
IDCONDICAO 04
condição de pagamento Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 21/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Descrição da forma de
DESCRRECEBIMENTO Texto 40
pagamento/recebimento
Percentual de Comissão por
PERCOMISSAO Decimal 10,2
forma de pagamento
Percentual de Mora diária por
PERMORADIARIA Decimal 10,4
atraso no pagamento
Flag identifica se a condição
FLAGENTRADA Texto 01
terá entrada
Quantidade de parcelas que
Número
possui a condição de QTDPAGAMENTOS 04
Inteiro
pagamento
Intervalo de dias entre uma Número
DIASINTERVALO 02
parcela e outra Inteiro
Intervalo de dias para a Número
DIASPRIMEIRAPARCELA 02
primeira parcela Inteiro
Percentual de acréscimo
PERACRESVENDA Decimal 10,4
financeiro sobre a venda
Valor mínimo da venda para
utilização da condição de VALORMINIMOUTILIZACAO Decimal 15,6
pagamento
‘P’ – Pré-fixada, ‘C’ –
Identifica o tipo da condição de
TIPOCONDICAOPGTO Texto 01 Convênio, ‘L’ – Boleto
pagamento relacionada
Logística.
Identifica se a forma de
pagamento pode ser utilizada
FLAGVENDACONSUMFINAL Texto 01
em vendas para consumidor
final
Identifica se a forma de
pagamento será utilizada nas FLAGSAIDA Texto 01
notas de saída
Identifica se a forma de
pagamento utiliza CobreBemX ( FLAGCOBREBEMX Texto 01
emissão de boletos
Identifica se a forma de
pagamento será utilizada em FLAGRECEBTITULO Texto 01
recebimento de título
Identifica se a forma de
pagamento é
FLAGCHEQUE Texto 01
recebimento/pagamento de
cheques
Identifica se a forma de
pagamento será utilizada em FLAGPAGAMTITULO Texto 01
pagamento de título
Identifica se a forma de
pagamento recebe cartão de FLAGCARTAOPRESENTE Texto 01
presente
Identifica se a forma de
pagamento será utilizada na FLAGFRENTECAIXA Texto 01
frente de caixa
Identifica se a forma de
pagamento refere-se a cartão FLAGCARTAOCREDITO Texto 01
de crédito/débito
PROMOCAO_GESTAO
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 22/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
PROMOCAO_GESTAO_CLIENTE
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IDPROMOCAO 04
Promoção Inteiro
Número
Código identificador do cliente IDCLIENTE 04
Inteiro
Identifica se a promoção por
FLAGINATIVO Texto 01 ‘T’, ‘F’
cliente está inativa
Registra a data de alteração da
DTALTERACAO Data
promoção
PROMOCAO_GESTAO_EMPRESA
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IDPROMOCAO 04
Promoção Inteiro
Código identificador da Número
IDEMPRESA 04
empresa Inteiro
Identifica se a promoção por
FLAGINATIVO Texto 01 ‘T’, ‘F’
empresa está inativa
Registra a data de alteração da
DTALTERACAO Data
promoção
PROMOCAO_GESTAO_FORMA_PAGAMENTO
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IDPROMOCAO 04
Promoção Inteiro
Código identificador da forma Número
IDPAGAMENTO 04
de pagamento Inteiro
Identifica se a promoção por
forma de pagamento está FLAGINATIVO Texto 01 ‘T’, ‘F’
inativa
Registra a data de alteração da
DTALTERACAO Data
promoção
PROMOCAO_GESTAO_PRODUTO
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IDPROMOCAO 04
Promoção Inteiro
Código identificador da Número
IDEMPRESA 04
empresa Inteiro
Código identificador da forma Número
IDPRODUTO 04
de pagamento Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 23/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
ESTRUTURA_MERCADOLOGICA
Informação Nome Técnico Tipo Tamanho Definições
Código identificador da Número
IDCATEGORIA 04
categoria Inteiro
Descrição da categoria DESCRCATEGORIA Texto 40
‘D’ – Divisão; ‘S’ – Seção; ‘G’
Identifica o tipo da categoria TIPOCATEGORIA Texto 01
– Grupo; ‘B’ – Subgrupo.
Código identificador do nível
anterior da categoria, utilizado Número
IDNIVELANTERIOR 04
quando configurado estrutura Inteiro
mercadológica integrada.
PRODUTOS_SALDO_ESTOQUE_EMPRESA
Informação Nome Técnico Tipo Tamanho Definições
Código identificador da Número
IDEMPRESA 04
empresa Inteiro
Número
Código interno do produto IDPRODUTO 04
Inteiro
Número
Código do item derivado IDSUBPRODUTO 04
Inteiro
Código identificador do local de Número
IDLOCALESTOQUE 04
estoque Inteiro
Descrição do local de estoque DESCRLOCALESTOQUE Texto 40
Identifica se o produto utiliza
FLAGLOTE Texto 01 ‘F’, ‘T’
controle de lote
Descrição do lote DESCRLOTE Texto 30
Identifica se o produto aceita
FLAGESTNEGATIVO Texto 01 ‘F’, ‘T’
estoque negativo
Quantidade atual em estoque,
por empresa, local de estoque
QTDSALDOATUAL Decimal 15,3
e lote (caso utilize a ultima
opção).
Quantidade de estoque em
QTDSALDORESERVA Decimal 15,3
reserva
Quantidade em estoque
disponível para venda,
QTDSALDODISPONIVEL Decimal 15,3
desconsiderando o saldo em
reserva
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 24/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
SET_PEDIDO
Informação Nome Técnico Tipo Tamanho Definições
Código Identificador da Número
IN_IDEMPRESA 08
empresa Inteiro
Código Identificador do Número
IN_IDCLIFOR 08
cliente/fornecedor Inteiro
“O” – Orçamento e “P” –
Tipo IN_TIPOPEDIDO Texto 01
Pedido de Vendas
Observações do Pedido de
IN_OBSERVACAO Texto 600
Vendas/ Orçamentos
Retorno
Campo Tipo Descrição
IDPEDIDO Número Inteiro Código identificador do pedido/orçamento inserido.
SET_ITEM_PEDIDO
Informação Nome Técnico Tipo Tamanho Definições
Código identificador do Número
IN_IDPEDIDO 04
pedido/orçamento Inteiro
Código identificador da Número
IN_IDEMPRESA 04
empresa Inteiro
Código identificador do Número
IN_IDVENDEDOR 04
vendedor Inteiro
Número
Código interno do produto IN_IDPRODUTO 04
Inteiro
Número
Código do item derivado IN_IDSUBPRODUTO 04
Inteiro
Número de sequência do
Número
item na gravação do IN_NUMSEQUENCIA 04
Inteiro
pedido/orçamento
Identificador do lote de
IN_IDLOTE Texto 30
produtos
Quantidade do item IN_QTDPRODUTO Decimal 12,3
Valor unitário bruto IN_VALUNITBRUTO Decimal 15,6
Valor total líquido do
IN_VALTOTLIQUIDO Decimal 14,2
produto
Valor de desconto do
IN_VALDESCONTOPRO Decimal 15,6
produto
Valor de desconto financeiro IN_VALDESCONTOFINANCEIRO Decimal 14,2
Valor de acréscimo do
IN_VALACRESCIMOPRO Decimal 15,6
produto
Valor de acréscimo
IN_VALACRESCIMOFINANCEIRO Decimal 14,2
financeiro
“A” – Aguardando, “E” –
Identificador do tipo da Encomenda, “I” – Imediata,
IN_TIPOENTREGA Texto 01
entrega “F” – Normal, “R” -
Representação
Percentual de comissão IN_PERCOMISSAO Decimal 15,6
Local de retirada para Número
IN_IDLOCALRETIRADAENTREGA
entrega do produto Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 25/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Retorno
Campo Tipo Descrição
STATUSITENSPEDIDO Número Inteiro Status dos itens do pedido, conforme tabela a baixo.
Status
Valor Descrição
0 Erro ao inserir itens do pedido/ orçamento.
1 Itens do pedido/ orçamento atualizados com sucesso.
2 Itens do pedido/ orçamento inseridos com sucesso.
SET_CLIFOR
Informação Nome Técnico Tipo Tamanho Definições
CNPJ ( Pessoa Jurídica) ou
AS_CPFCNPJ Texto 14
CPF ( Pessoa Física)
Nome do cliente/ fornecedor AS_NOME Texto 80
Endereço AS_RUA Texto 80
Número AS_NUMERO Texto 10
Complemento AS_COMPLEMENTO Texto 80
Bairro AS_BAIRRO Texto 40
CEP AS_CEP Texto 08
Endereço de Cobrança AS_RUACOBRANCA Texto 80
Número de Cobrança AS_NUMEROCOBRANCA Texto 10
Complemento de Cobrança AS_COMPLEMENTOCOBRANCATexto 80
Bairro de Cobrança AS_BAIRROCOBRANCA Texto 40
Número
CEP de Cobrança AS_CEPCOBRANCA 04
Inteiro
Número do Telefone AS_FONE Texto 20
Número do Celular AS_FONECELULAR Texto 20
E-mail AS_EMAIL Texto 200
Código identificador do
Número
usuário do usuário que AI_IDUSUARIOCADASTRO 04
Inteiro
realizou o cadastro
Observações LS_OBSGERAL Longvarchar 32700
Retorno
Campo Tipo Descrição
IDCLIENTE Número Inteiro Código identificador do cliente inserido.
EXCLUIR_PEDIDO
Informação Nome Técnico Tipo Tamanho Definições
Código identificador do Número
IN_IDPEDIDO 04
pedido/orçamento Inteiro
Código identificador da Número
IN_IDEMPRESA 04
empresa Inteiro
Retorno
Campo Tipo Descrição
Status da exclusão do pedido, conforme tabela a
STATUSDELETEPEDIDO Número Inteiro
baixo.
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 26/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Status
Valor Descrição
0 Erro ao excluir pedido/ orçamento.
1 Pedido/ orçamento eliminado com sucesso.
2 Pedido/ orçamento já efetivado, não podendo ser eliminado.
3 Pedido/ orçamento não existe no banco de dados.
SET_PEDIDO_COMPRA
Informação Nome Técnico Tipo Tamanho Definições
Código identificador da Número
IN_IDEMPRESA 04
empresa Inteiro
Código identificador do Número
IN_IDCLIFOR 04
fornecedor Inteiro
Código identificador da forma Número
IN_IDPAGAMENTO 04
de pagamento Inteiro
Código identificador da Número
IN_IDEMPRESAEMITENTE 04
empresa emitente do pedido Inteiro
Número de dias para entrega Número
IN_DIASENTREGA 04
do pedido de compras Inteiro
Percentual de desconto geral
IN_PERDESCONTO Decimal 10,6
do pedido
Valor do frete IN_VALFRETE Decimal 15,6
Identificador do tipo de “P” – Frete pago; “A” – Frete
IN_TIPONATUREZAFRETE Texto 01
natureza do frete a pagar
Identificador do tipo de rateio
IN_TIPORATEIOFRETE Texto 01 “V” – Valor, “P” - Peso
do frete
Identificador do tipo de “C” – Frete conhecimento; “N”
IN_TIPODOCFRETE Texto 01
documento do frete – Frete nota
Identificador do tipo de “E” – Embalagem; “U” -
IN_TIPOEMBALPEDIDO Texto 01
embalagem do pedido Unidade
Observação geral do pedido IN_OBSGERAL Texto 300
Número
Identificador do usuário IN_IDUSUARIO 04
Inteiro
Retorno
Campo Tipo Descrição
IDPEDIDO Número Inteiro Código identificador do pedido inserido
STATUSPEDIDO Número Inteiro Status do pedido, conforme tabela a baixo.
Status
Valor Descrição
0 Erro ao gravar pedido de compras.
1 Pedido de compras gravado com sucesso.
SET_PEDIDO_COMPRA_PROD
Informação Nome Técnico Tipo Tamanho Definições
Código identificador do pedido Número
IN_IDPEDIDO 04
de compras Inteiro
Número
Código interno do produto IN_IDPRODUTO 04
Inteiro
Número
Código do item derivado IN_IDSUBPRODUTO 04
Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 27/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Número
Código interno do fornecedor IN_IDCLIFOR 04
Inteiro
Código identificador da Número
IN_IDEMPRESA 04
empresa Inteiro
Quantidade solicitada para o
IN_QTDSOLICITADA Decimal 12,3
produto
Valor unitário bruto, não
considera descontos e IN_VALUNIT Decimal 15,6
acréscimos.
Valor total bruto (valor unitário
IN_VALTOTBRUTO Decimal 15,6
bruto * quantidade)
Valor total líquido ( valor
unitário + quantidade + IN_VALTOTLIQUIDO Decimal 15,06
acréscimos e descontos)
Percentual de desconto do
IN_PERDESCONTOITEM Decimal 10,6
item
Percentual de ICMS IN_PERICM Decimal 10,6
Valor do ICMS Substituição IN_VALICMSSUBST Decimal 15,6
Percentual de frete do produto IN_PERFRETEITEM Decimal 10,6
Percentual de adicional do itemIN_PERADICIONAL Decimal 10,6
Percentual de IPI IN_PERIPI Decimal 10,6
Valor de IPI IN_VALIPI Decimal 15,6
Percentual de IPI sobre o frete IN_PERIPIFRETE Decimal 10,6
Percentual de IPI sobre
IN_PERIPIADICIONAL Decimal 10,6
adicionais
Valor de desconto sobre ICMS IN_VALDESCONTOICMS Decimal 15,6
‘T’ – Tributado; ‘I’ – Isento; ‘D’
– Diferido; ‘S’ – Suspenso; ‘F’
Situação tributária do produto IN_TIPOSITTRIB Texto 01
– Substituição Tributária; ‘A’ –
Substituição Fronteira;
Percentual de acessórios IN_PERACESSORIOS Decimal 10,6
Percentual de IPI sobre
IN_PERIPIACESSORIOS Decimal 10,6
acessórios
Data para entrega do produto IN_DTENTREGA Data
Retorno
Campo Tipo Descrição
STATUSITENSPEDIDO Número Inteiro Status dos itens do pedido, conforme tabela a baixo.
Status
Valor Descrição
0 Erro ao gravar pedido de compras.
1 Item do pedido gravado com sucesso.
SET_PEDIDO_COMPRA_VCTO
Informação Nome Técnico Tipo Tamanho Definições
Código identificador da Número
IN_IDEMPRESA 04
empresa Inteiro
Código identificador do Número
IN_IDCLIFOR 04
fornecedor Inteiro
Código identificador do pedido Número
IN_IDPEDIDO 04
de compras Inteiro
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 28/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Número
Número da parcela IN_DIGITODUP 04
Inteiro
Valor da parcela IN_VALDUP Decimal 14,2
Data de vencimento da parcela IN_DTVENCIMENTO Data
Retorno
Campo Tipo Descrição
Status do vencimento do pedido, conforme tabela a
STATUSPEDIDOVCTO Número Inteiro
baixo.
Status
Valor Descrição
0 Erro ao gravar pedido de compras.
1 Vencimento do pedido gravado com sucesso.
9. ERROS COMUNS
O integrim é case-sensitive, por este motivo é importante tomar cuidado com letras maiúsculas/minusculas, espaços,
caracteres especiais e etc..
É importante validar se o acesso ao CIM esta liberado, muitas vezes ao realizar a chamada de um serviço, é retornado
como indisponível. (404).
Uma forma simples é colar no navegador o endereço que esta tentando chamar na requisição. Por exemplo:
127.0.0.1:4664.
Esta é uma forma simples que te permite validar se o cim esta disponível para maquina em que esta testando e se as
aplicações (integrim e CISS Auth estão instaladas)
Muitas vezes podemos realizar a chamada de campos inválidos ou fora da estrutura padrão do json, O manual conta
com vários exemplos para ajudar neste caso.
É comum o problema onde o usuário para integração não esta cadastrada no CISSPODER, neste caso realizando o
teste apontado no 'Serviço indisponível por bloqueio nos acessos' te ajudara validar se o usuário existe e tem acesso
ao cim.
O serviço chamado pode não existir na quela base ou por algum problema não foi instalado.
Para estes casos, podem validar se o serviço existe através do relatório 854- Serviços Integrim.
Em casos onde ele é um serviço padrão (numeração superior a 1000000 e existe no manual), tente reinstalar o
integrim.
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 29/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS
Existe uma base de versionamento na CISS, ao realizar uma alteração em um serviço padrão, corre-se o risco de
esta alteração ser perdida na próxima atualização destes serviços.
Para alteração especifica de cliente, é importante cadastrar um novo serviço com numeração inferior a 1000000, e
repassar a CISS para versionamento
Neste caso tente atualizar o modulo, pelo monitor key, se o problema continuar sera necessário contactar o setor
comercial da CISS para liberação do modulo.
Ao realizar a chamada de um serviço, se o modulo estiver bloqueado ira retornar o código 403 no status com a
mensagem: "Acesso Negado! Entre em contato com o setor comercial da CISS para liberar o módulo do Integrim."
(https://ciss.com.br)
https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 30/30