Você está na página 1de 30

20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS

Manual - Serviços de Integração CISSPoder - Integrim


Criado por: Central de Atendimento CISS
Modificado em: Ter, 20 Abr, 2021 at 2:15 PM

Departamento Gestão de Dados Versão

Atividade Manual - Serviços de Integração CISSPoder - Integrim 2.0

Elaborado por: Adrielli Lewandowski Elaborado em: 02/07/2018

Revisado por: Jonas Techy Potrich Revisado em: 26/05/2020

Revisado por: Marcos Willian Garcia de Barros Revisado em: 08/06/2020

Revisado por: Jonas Techy Potrich Revisado em: 20/04/2021

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.

Imagem 1 - Requisições ao Integrim

1 - REST: Nesse momento é feita a requisição para a API.


2 - TOKEN: É solicitado ao CIM (CISSAUTH) o Token de acesso para autoriza o acesso ao Integrim.
3 - REST: Nessa etapa é consumido os serviços do Integrim.
4 - SERVIÇOS: A API INTEGRIM consulta ou executa funções no banco de dados para executar o serviço
selecionado.

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.

4.1. Instalando o CISSPoderAuth

Acessar o CIM Client na sua máquina e na opção Todos pesquisar por CISSPoderAuth e clicar em Mais Detalhes do
aplicativo:

Imagem 2 - Instalando CISSPoderAuth

Será apresentado o detalhamento do aplicativo, clicar no botão Instalar:

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

Imagem 3 - Instalando CISSPoderAuth

Na sequência é apresentado tela para informar as configurações de acesso ao banco de dados:

Imagem 4 - Instalando CISSPoderAuth

Após confirmar o processo de instalação é feita automaticamente, ao final apresentado mensagem:

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

Imagem 5 - Instalando CISSPoderAuth

4.2. Instalando o INTEGRIM

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:

Imagem 6 - Instalando Integrim

Será apresentado o detalhamento do aplicativo, clicar no botão Instalar:

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

Imagem 7 - Instalando Integrim

Na mensagem apresentada, serão listados os pré-requisitos, caso atenda confirmar em SIM:

Imagem 8 - Instalando Integrim

Na sequência é apresentado tela para informar as configurações de acesso ao banco de dados:

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

Imagem 9 - Instalando Integrim

Após confirmar o processo de instalação é feita automaticamente, ao final apresentado mensagem:

Imagem 10 - Instalando Integrim

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.

Usuário criado no CISSPODER para autenticação.

5.2. Instalando o POSTMAN

A aplicação pode ser facilmente instalada como uma extensão do browserGoogle Chrome.

5.3. Obtendo o Token

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.

Imagem 11 - Utilizando Postman

5.3.1. Informar o endereço de rede da aplicação CISSPoderAuthacrescido expressão “oauth/token” (Item 01 da


imagem 11).
5.3.2. Escolher a opção POST para o tipo de requisição (Item 02 da imagem 11).
5.3.3. Verificar que o endereço do item 03 deve ser o mesmo informado no Passo 01 (Item 03 da imagem 11).
5.3.4. Selecionar a aba “Headers” para inserir a próxima configuração(Item 04 da imagem 11).
5.3.5. Inserir uma chave do tipo “Content-Type” com valor “application/xwww-from-urlencoded” (Item 05 da imagem 11)

Imagem 12 - Utilizando Postman

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):

Key: password Value: *****


Key: username Value: *****
Key: grant_type Value: password
Key: client_secret Value: poder7547
Key: client_id Value: cisspoder-oauth

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

5.4. Realizando a Requisição

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:

Imagem 13 - Utilizando Postman

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):

Key: Content-Type Value: application/json


Value: Bearer “token obtido na
Key: Authorization
configuração anterior”

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

Imagem 14 - Utilizando Postman

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

A seguir, exemplos de requisições com alguns dos serviços padrões:Versão 16


https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 9/30
20/04/2021 Manual - Serviços de Integração CISSPoder - Integrim : CISS

Imagem 15 - Exemplo de requisição

Imagem 16 - 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

Imagem 17 - Exemplo de requisição

Imagem 18 - Exemplo de requisição

Imagem 19 - Exemplo de requisição


https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 11/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).

Imagem 20 - Exemplo de requisição

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

Também segue a baixo a lista de serviços disponíveis:

Serviços de Integração CISSPoder


Nome Serviço Descritivo
Disponibiliza dados gerais das lojas cadastradas no
CAD_LOJAS
banco de dados CISSPoder.
Disponibiliza dados gerais de todos os tipos de pessoas
CAD_PESSOAS cadastradas no banco de dados CISSPoder, sejam elas
físicas ou jurídicas.
Disponibiliza dados gerais dos produtos e suas
CAD_PRODUTOS respectivas estruturas mercadológicas presentes no
banco de dados CISSPoder.
Disponibiliza dados gerais de documentos fiscais de
DOCUMENTOS_FISCAIS_ENTRADA entrada, registrados para as lojas cadastradas no banco
de dados CISSPoder.
Disponibiliza dados de documentos fiscais de saída
DOCUMENTOS_FISCAIS_SAIDA registrados para as lojas cadastradas no banco de dados
CISSPoder.
Disponibiliza dados dos itens presentes nos documentos
ITENS_DOCUMENTOS_FISCAIS_ENTRADA fiscais de entrada registrados para as lojas cadastradas
no banco de dados CISSPoder.
Disponibiliza dados dos itens presentes nos documentos
ITENS_DOCUMENTOS_FISCAIS_SAIDA fiscais de saída registrados para as lojas cadastradas no
banco de dados CISSPoder.

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

Disponibiliza dados dos pagamentos referentes aos


PAGAMENTOS_DOCUMENTOS_FISCAIS_ENTRADA documentos fiscais de entrada registrados para as lojas
cadastradas no banco de dados CISSPoder.
Disponibiliza dados dos recebimentos referentes aos
RECEBIMENTOS_DOCUMENTOS_FISCAIS_SAIDA documentos fiscais de saída registrados para as lojas
cadastradas no banco de dados CISSPoder.
Disponibiliza dados de precificação e custo dos produtos
PRECOS_CUSTOS_PRODUTOS_EMPRESA separados por empresa, os dados disponibilizados são
referentes aos preços e custos atuais.
Disponibiliza os preços cadastrados por cliente em
PRECOS_POR_CLIENTE “Compras\Manutenção de Preços de Venda e Ofertas\
Preços por Clientes”.
Disponibiliza dados de formas de pagamento/
CONDICOES_FORMA_PAGAMENTO_RECEBIMENTO recebimento e as condições de pagamento relacionadas
que estão cadastradas no banco de dados CISSPoder.
Disponibiliza as promoções de vendas cadastradas em
PROMOCAO_GESTAO ‘Compras\Gestão de Promoções\ Cadastro de
Promoções Avançadas’
Disponibiliza relação dos clientes que pertencem a
PROMOCAO_GESTAO_CLIENTE promoção (quando cadastrado). Está vinculada
diretamente com o serviço PROMOCAO_GESTAO
Disponibiliza a relação das empresas em que a
PROMOCAO_GESTAO_EMPRESA promoção encontra-se em vigente. Está vinculada
diretamente ao serviço PROMOCAO_GESTAO.
Disponibiliza a relação de formas de pagamento em que
se aplica o preço de promoção ( quando cadastrado).
PROMOCAO_GESTAO_FORMA_PAGAMENTO
Está vinculada diretamente com o serviço
PROMOCAO_GESTAO.
Disponibiliza a relação de produtos que pertencem a
PROMOCAO_GESTAO_PRODUTO promoção. Está vinculada diretamente com o serviço
PROMOCAO_GESTAO.
Disponibiliza dados referente à estrutura mercadológica
da empresa ( Divisão\Seção\Grupo\Subgrupo) permitindo
ESTRUTURA_MERCADOLOGICA
também o controle da estrutura mercadológica integrada,
apresentando o vínculo entre os níveis da estrutura.
Disponibiliza o saldo atual em estoque dos produtos,
PRODUTOS_SALDO_ESTOQUE_EMPRESA apresentando por empresa, local de estoque e lote (este
ultimo caso seja utilizado controle de estoque).
Insere na base de dados do CISSPoder as informações
SET_PEDIDO
gerais do pedido de vendas.
Insere na base de dados do CISSPoder os itens que
SET_ITEM_PEDIDO
compõem o pedido de vendas.
Insere na base de dados do CISSPoder o cadastro de
SET_CLIFOR
novos clientes/fornecedores.
Eliminar pedidos de venda/ orçamento na base de dados
EXCLUIR_PEDIDO do CISSPoder, a opção é possível apenas para os
pedidos/orçamentos não efetivados.
Insere na base de dados do CISSPoder as informações
SET_PEDIDO_COMPRA
gerais do pedido de compras.
Insere na base de dados do CISSPoder os itens que
SET_PEDIDO_COMPRA_PROD
compõem o pedido de compras.
Insere na base de dados do CISSPoder as informações
SET_PEDIDO_COMPRA_VCTO
referente ao financeiro do pedido de compras.

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

8. DETALHAMENTO DOS SERVIÇOS

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

Número NUMERO Texto 10


Bairro BAIRRO Texto 40
Cidade DESCRCIDADE Texto 200
CEP IDCEP Número Inteiro 08
Complemento COMPLEMENTO Texto 80
Sigla da unidade de federação,
Estado UF Texto 02
estado.
Região DESCRREGIAO Texto 40
Observação OBSGERAL Texto 32700
Contato 01 NOMECONTATO1 Texto 80
Contato 02 NOMECONTATO2 Texto 60
Telefone Comercial FONE2 Texto 20
Telefone ResidencialFONE1 Texto 20
Fax FONEFAX Texto 20
Celular FONECELULAR Texto 20
E-mail EMAIL Texto 200
Inscrição Municipal INSCRMUNICIPAL Texto 20
Inscrição Estadual INSCRESTADUAL Texto 20
Descrição da
DESCRATIVIDADE Texto 100
Atividade
Descrição do Grupo
DESCRGRUPOECONOMICO Texto 40
Econômico
Suspenso, Bom, Ótimo, Completar
Situação DESCRSITUACAO Texto 30
Cadastro.
Limite de Convênio VALLIMITECONVENIO Número Decimal 14,2
Limite de Crédito VALLIMITECREDITO Número Decimal 14,2
Regime Federal TIPOREGIMETRIBFEDERAL Texto 01
Tipo Regime TIPOREGIMETRIBUTACAO Texto 01
Data de Alteração DTALTERACAO Data
Código da
Identificação do GENERO Texto 01 “M” – Masculino; “F” - Feminino
gênero do cadastro

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

Código do Fabricante IDMARCAFABRICANTE Número Inteiro 04


Descrição do
DESCRICAO Texto 40
Fabricante
Embalagem de
EMBALAGEMENTRADA Texto 02
Entrada
Gramatura de Entrada VALGRAMAENTRADA Decimal 15,6
Embalagem de Saída EMBALAGEMSAIDA Texto 02
Gramatura de Saída VALGRAMASAIDA Decimal 12,3
NCM NCM Texto 08
Status FLAGINATIVO Texto 01 "F" - Ativo, "T" - Inativo
Data de Alteração DTALTERACAO Data
Percentual de IPI PERIPI Decimal 10,2
Data do cadastro DTCADASTRO Data
CNPJ do fabricante
que relacionada a CNPJFABRICANTE Texto 14
marca

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

Código Identificador de Número


IDPLANILHA 08
Documento Inteiro
Código Identificador do Número
IDCLIFOR 08
Cliente Inteiro
Número
Código Identificado do Caixa IDCAIXA 04
Inteiro
Nome \ Razão Social do
NOME Texto 80
Cliente
Número
Número do Documento Fiscal NUMNOTA 04
Inteiro
Série SERIENOTA Texto 03
Modelo MODELO Texto 03
Valor Total VALCONTABIL Decimal 14,2
Valor de Desconto VALDESCONTOFINANCEIRO Decimal 15,6
Valor de Acréscimo VALACRESCIMOFINANCEIRO Decimal 15,6
Valor de Impostos Não
VALIMPOSTOS Decimal 15,6 IPI + PIS + COFINS + ICMS
Recuperáveis
Valor do Frete VALFRETENOTA Decimal 14,2
Data de Movimento DTMOVIMENTO Data/Hora
Chave Eletrônica CHAVENFE Texto 44
Tipo TIPONOTA Texto 01 "S" - Entrada, "D" - Devolução.
Data de Emissão DTEMISSAO Data
Código fornecido pela
instituição de benefício ou CODIGOEXTERNO Texto 30
CPF do cliente
Identificador da forma de Número
IDFORMAPGTO 4
pagamento utilizada Inteiro
Descrição da forma de
DESCRFORMAPGTO Texto 40
pagamento utilizada
Valor do título VALTITULO Decimal 14,2
Identificador do usuário do Número
IDUSUARIO 4
sistema Inteiro
Nome do usuário do sistema NOMEUSUARIO Texto 40
CPF do vendedor CPFVENDEDOR Texto 11
Contador de Ordem de Número
COO 04
Operação na ECF Inteiro
Número de série da
NUMSERIEIMPRES Texto 25
impressora fiscal
Informação se a impressora Número
TRUNCROUND 01 0 – Arredonda; 1 – Trunca;
fiscal arredonda ou trunca Inteiro
Identifica se a nota fiscal está
FLAGNOTACANCEL Texto 01 ‘T’; ‘F’
cancelada ou não

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

Código Identificador da Número


IDTITULO 04
Duplicata Inteiro
Número da Parcela DIGITOTITULO Texto 02
Série da nota fiscal a qual se
SERIENOTA Texto 03
refere o título
Código Identificador da Forma Número
IDRECEBIMENTO 04
de Pagamento Inteiro
Descrição da Forma de
DESCRRECEBIMENTO Texto 40
Pagamento
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

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

Informação Nome Técnico Tipo Tamanho Definições


Código Identificador da Número
IDPROMOCAO 04
Promoção Inteiro
Descrição da Promoção DESCRPROMOCAO Texto 60
Data inicial da promoção DTINIPROMOCAO Data
Data final da promoção DTFIMPROMOCAO Data
Identifica se a promoção está
FLAGINATIVO Texto 01 ‘T’, ‘F’
inativa ou não.
Registra a data de alteração da
DTALTERACAO Data
promoção

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

Identifica se a promoção por


forma de pagamento está IDSUBPRODUTO Texto 01 ‘T’, ‘F’
inativa
Ordem da digitação dos Número
NUMSEQUENCIA 04
produtos na promoção Inteiro
Preço do item em promoção VALPROMOCAO Decimal 18,6
Quantidade mínima do item
QTDMINIMA Decimal 9,3
para ser aplicada a promoção
Quantidade máxima do item
QTDMAXIMA Decimal 9,3
para ser aplicada a promoção
Identifica se a promoção por
FLAGINATIVO Texto 01
produtos está inativa
Registra a data de alteração da
DTALTERACAO Data
promoção

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

Data de Alteração DTALTERACAO Data

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

Código identificador do local Número


IN_IDLOCALRETIRADA
de retirada Inteiro

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

9.1 Ao tentar testar ou configuração, inserir uma letra ou caractere invalido.

O integrim é case-sensitive, por este motivo é importante tomar cuidado com letras maiúsculas/minusculas, espaços,
caracteres especiais e etc..

9.2 Serviço indisponível por bloqueio nos acessos

É 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)

9.3 Parâmetros inválidos na chamada.

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.

9.4 - Problemas no acesso devido a usuário invalido.

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

9.5 - Serviço inexistente

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

Se assim mesmo o problema continuar, acione o suporte.

9.6 - Alterar serviços padrões.

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

9.7 - Modulo Bloqueado

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

C Central é o autor deste artigo de solução.

Central de Atendimento CISS

(https://ciss.com.br)

https://meajuda.ciss.com.br/support/solutions/articles/35000082795-manual-serviços-de-integração-cisspoder-integrim 30/30

Você também pode gostar