INTEGRAÇÃO SICACRED
ENVIO DE INFORMAÇÕES PARA O SICACRED
Devera-se preencher as tabelas de Parâmetros, Clientes, Compras, Documentos e Formas de
Pagamento no Bancos de Dados Microsoft SQL Server, Oracle OU Popular objeto e enviar a requisição a
nossa API serializando em JSON.
RECEBIMENTO DE INFORMAÇÕES DO SICACRED
Solicitar requisição a nossa API e receber um retorno JSON
DEFINIÇÕES GERAIS ENVIO DE INFORMAÇÕES
O nome da tabela de Parâmetros utilizados deverá ser SICAPRM. Esta deverá armazenar
Parâmetros: Código da Fonte e a Última Data em que foi atualizada (Preenchidas) as tabelas de Clientes,
Compras e Documentos. Esta tabela SOMENTE TERÁ UMA LINHA PARA CADA FONTE.
O nome da tabela que deverá armazenar os Dados Cadastrais dos Clientes será SICACLI.
O nome da tabela que deverá armazenar as Compras dos clientes será SICACPR.
Na SICACPR tenho um registro por compra, em caso de pagar essa COMPRA em mais de
uma forma de pagamento terei um registro para cada Forma de Pagamento, sendo o Valor da
Compra o Valor Pago na Forma de Pagamento.
O nome da tabela de Documentos será SICADOC. Essa deverá armazenar os títulos dos clientes,
ou seja. duplicatas, cheques, notas promissórias, depósitos bancários e outros tipos de documentos que
estabeleçam a dívida do cliente com a empresa e os pagamentos das compras (SICACPR), no caso de
compras em parcelas, teremos aqui as parcelas. IMPORTANTE: BAIXA PARCIAL, então teremos que
ter um ou mais títulos referentes aos pagamentos efetuados e um título EM ABERTO com o que ainda
está devendo.
O nome da tabela que deverá armazenar o mapeamento (DE – PARA) das Formas de
Pagamentos e Tipos de Documento da FONTE para o SICA será SICAFmpMap.
Nos campos onde solicitar Tipos de Documento ou Formas de Pagamento, os tipos
válidos para o SICACRED, são:



AV - À VISTA (Dinheiro/ Cheque Para o Dia/PIX)
CH – CHEQUE PRÉ-DATADO
CD – CHEQUE (Quando for Devolvido)
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
1


SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845   e-mail:sac@grnegocios.com.br  www.sicacred.com.br
2
 DP – DUPLICATA
 NP – NOTA PROMISSÓRIA
 BL – BOLETO BANCARIO
 DB – DEPÓSITO BANCARIO
 CA – CARTÃO
 CT – CARTEIRA

ESQUEMA DAS TABELAS GRAVAÇÃO OU ENVIO PARA O SICACRED
fSicaCpr_Cli
Upd(R); Del(C);cpa
fSicaDoc_Cli
Upd(R); Del(C);cpa
fSicaFmpMap_Fmp
Upd(R); Del(R);cpa
fSicaCli_Fte
Upd(R); Del( );cpa
Reference_6
Upd( ); Del( );cpa
Reference_7
Upd( ); Del( );cpa
SICACLI
CODFONTE
COD_CLI
DT_CAD
R_SOCIAL
N_FANTAS
CNPJ_CPF
INS_ESTADUAL
END_CLI
BAIRRO
CIDADE
UF
CEPCLI
FONE1
FONE2
EMAIL
SITUACAO
OBS
FORMAS_P
PRZ_PGTO
LIMITE
char(7)
varchar(15)
datetime
varchar(100)
varchar(100)
varchar(18)
varchar(18)
varchar(120)
varchar(60)
varchar(60)
char(2)
varchar(10)
varchar(20)
varchar(20)
varchar(80)
varchar(20)
varchar(100)
varchar(15)
varchar(15)
numeric(14,2)
<pk,fk>
<pk>
not null
not null
not null
not null
null
not null
null
not null
null
null
not null
null
null
null
null
not null
null
null
null
not null
SICADOC
CODFONTE
COD_DOC
COD_CLI
DT_EMI
DT_VENC
DT_PGTO
VL_DOC
VL_PGT
CodFmpFte
char(7)
varchar(40)
Varchar(15)
datetime
datetime
datetime
numeric(14,2)
numeric(14,2)
varchar(10)
<pk,fk1,fk2>
<pk>
<fk1>
<fk2>
not null
not null
not null
not null
not null
null
not null
null
not null
iSicaDoc1
iSicaDoc2
SICACPR
CODFONTE
COD_CPR
COD_CLI
DT_CPR
VL_CPR
FOI_PRAZ
CodFmpFte
char(7)
varchar(20)
varchar(15)
datetime
numeric(14,2)
char(1)
varchar(10)
<pk,fk1,fk2>
<pk>
<fk1>
<fk2>
not null
not null
not null
not null
not null
not null
not null
iSicaCpr1
SICAPRM
CODFONTE
DT_ATU
DT_INI
DT_FIM
char(7)
datetime
datetime
datetime
<pk> not null
not null
not null
not null
SICAFMP
COD_FMP
NOM_FMP
char(2)
varchar(30)
<pk> not null
not null
SICAFmpMap
CODFONTE
CodFmpFte
COD_FMP
char(7)
varchar(10)
char(2)
<pk>
<pk>
<fk>
not null
not null
not null

LAYOUT DAS TABELAS OU OBJETOS DE ENVIO PARA O SICACRED
Os Tipos de Dados (Coluna Tipo) no layout, são:
A – Alfanuméricos => Corresponde ao tipo Char (quando fixo) ou Varchar.
N – Numéricos => Corresponde ao tipo Number ou Numeric.
D – Data => Corresponde ao tipo DateTime, mas somente armazenar a DATA.
Na coluna Obrig. no Layout do arquivo, no caso de existir um SIM, significa que o
preenchimento do campo é obrigatório, as regras do preenchimento e validação estão na descrição da
coluna. Os campos não obrigatórios somente ficaram sem ser preenchidos, caso não se tenha
como tirar a informação no sistema.
No caso do campo não ser obrigatório e não tiver como gerar a informação, então o
mesmo não deverá ser preenchido, independente do tipo de dado da informação. Por exemplo, se o
campo for numérico e não tem como preencher a informação, não se deverá colocar o valor 0 (zero) no
campo, ou seja, deverá ficar NULL.
Tabela\Objeto SICAPRM
Coluna
Tipo
Tam Dec Descrição
CODFONTE
A
007
Obrig.
Código da Fonte informado pelo SICACRED
DT_ATU
D
010
Sim
Último dia em que foi feito o preenchimento das tabelas de
CLIENTES, COMPRAS e DOCS
DT_INI
D
010
Sim
Data Inicial do Período Utilizado Para filtrar os registros
DT_FIM
D
010
Sim
Data Final do Período Utilizado Para filtrar os registros.
Geralmente deverá ser a mesma DT_ATU.
CodGrpEmp
N
009
Sim
0 Código da Conta GR criada para o cliente. Obrigatório
EmlRspFte
A
300
SOMENTE no envio pela API
Emails para notificar sobre as informações. Também utilizado
no caso do envio via API. Caso seja mais de um email, então
separar o emails com “;”
Tabela\Objeto SICACLI
Coluna
Tipo
Tam Dec Descrição
Sim
Sim
Obrig.
CODFONTE
A
007
Código da Fonte
COD_CLI
A
015
Sim
Identificador interno do cliente \ Código do cliente na
empresa \ Número Seqüencial. Código Único que identifica o
cliente no sistema, geralmente é o código do cliente no
sistema
DT_CAD
D
010
Sim
Data do cadastro do cliente na empresa (No caso de não ter
Data de Cadastro, colocar a Data da Primeira Compra).
R_SOCIAL
A
100
Sim
Razão Social do Cliente Pessoa Jurídica ou Nome do Cliente
(Pessoa Física)
N_FANTAS
A
100
Sim
Nome Fantasia
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
3


SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845   e-mail:sac@grnegocios.com.br  www.sicacred.com.br
4
CNPJ_CPF A 018  CNPJ ou CPF do cliente Sim
INS_ESTADUAL A 018  Inscrição Estadual do Cliente
END_CLI A 120  Endereço do Cliente Sim
BAIRRO A 060  Bairro do Cliente
CIDADE A 060  Cidade do Cliente
UF A 002  UF do Cliente Sim
CEPCLI A 010  CEP Cliente
FONE1 A 020  Fone1 do Cliente
FONE2 A 020  Fone2 do Cliente
EMAIL A 080  e-mail do Cliente
SITUACAO A 020  Situação do Cliente na empresa: Ativo, Inativo, Negativo ou
Bloqueado. Sim
OBS A 100  Observação sobre o cliente
FORMAS_P A 015
Formas de como o cliente pode pagar na empresa
(AV/DP/CH...). As formas de pagamento válidas são:AV-CH
CD-DP-NP-CT-BL-DB

PRZ_PGTO A 015  Prazo de pagamento do cliente na fonte (15/30, ou
30/60/90/120 ou 30/60)
LIMITE N 014 2 Limite de Crédito do Cliente na Empresa  Sim

Tabela\Objeto SICACPR
Coluna Tipo Tam Dec Descrição Obrig.
CODFONTE A 007  Código da Fonte Sim
COD_CPR A 020
Código da Compra.Código do documento de saída, número e
série da nota fiscal ou um código gerado pelo sistema. Este
código deve ser único para cada registro. Em caso de
Compras com mais de uma forma de pagamento pode ser
concatenar com um sequencial.
Sim
COD_CLI A 015  Identificador interno do cliente \ Código do cliente na
empresa \ Número Seqüencial Sim
DT_CPR D 010  Data da Compra Sim
VL_CPR N 014 2 Valor da Compra na Forma de Pagamento Sim
FOI_PRAZ A 001
Compra à Prazo. Se a Compra Foi Á Prazo então Preencher
com "S", mas se a compra foi À Vista então preencher com
"N". A VISTA (AV) é única forma de pagamento aceita
para quando o pagamento NÃO É Á PRAZO. E se forma
de pagamento AV, então SOMENTE pode ficar aqui
como “N”, caso contrário irá dá erro.
Se FOI_PRAZ = “N” Então CodFmpFte IGUAL a “AV”
Se não FOI_PRAZ = “S” Então CodFmpFte nunca pode
ser  “AV”
Sim
CodFmpFte A 010  Forma de Pagamento da Compra Sim



SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845   e-mail:sac@grnegocios.com.br  www.sicacred.com.br
5
Tabela\Objeto SICADOC
Coluna Tipo Tam Dec Descrição Obrig.
CODFONTE A 007  Código da Fonte Sim
COD_DOC A 030
Código do Documento. Dados do cheque (Numero, Agência e
Banco), Código da Duplicata, Código do Boleto, ou seja, um
identificador do documento. Este código deverá ser único
para cada registro.
Sim
COD_CLI A 015   Identificador interno do cliente \ Código do cliente na
empresa \ Número Seqüencial Sim
DT_EMI D 010   Data de Emissão do Documento Sim
DT_VENC D 010   Data do Vencimento do Documento Sim
DT_PGTO D 010   Data do Pagamento do Documento
VL_DOC N 014 2 Valor do Documento  Sim
VL_PGT N 014 2 Valor Pago
CodFmpFte A 010   Tipo do Documento. Sim


Tabela\Objeto SICAFMP
Coluna Tipo Tam Dec Descrição Obrig.
COD_FMP A 002   Código da Forma de Pagamento e/ou Tipo de Documento Sim
NOM_FMP A 030   Nome da Forma de Pagamento e/ou Tipo de Documento Sim


Tabela\Objeto SICAFmpMap
Coluna Tipo Tam Dec Descrição Obrig.
CODFONTE A 007  Código da Fonte Sim
CodFmpFte A 010   Código da Forma de Pagamento na Fonte Sim
COD_FMP A 002   Código da Forma de Pagamento e/ou Tipo de Documento no
SICA. AV-CH-CD-DP-NP-CA-BL-DB-CT Sim


Objeto DtoSicaConsultaDatas – Retorna informações para geração dos dados.
Coluna Tipo Tam Dec Descrição Obrig.
CodFonte A 007  Código da Fonte Sim
CodGrpEmp A 010   Código do Grupo Empresa da Fonte Sim
Chave A 002   Chave do Grupo Empresa da Fonte Sim
OBSERVAÇÕES GERAIS
Na tabela SICAFMP teremos os registros abaixo:
COD_FMP
(CODIGO)
NOM_FMP
(DESCRIÇÃO)
AV
A VISTA (Dinheiro/ Cheque Para o Dia/PIX)
CH
CHEQUE PRE-DATADO
CD
CHEQUE DEVOLVIDO
DP
DUPLICATA
NP
NOTA PROMISSORIA
BL
BOLETO BANCARIO
DB
DEPOSITO BANCARIO
CA
CARTAO
CT
CARTEIRA
OBSERVAÇÃO 1: As tabelas deverão ser preenchidas com os dados do sistema da empresa, ou seja,
funcionará como uma base de dados paralela do sistema oficial da empresa.
OBSERVAÇÃO 2: Nas compras (SICACPR) com mais de uma forma de pagamento, então gerar um
registro para cada forma de pagamento.
OBSERVAÇÃO 3: Nos títulos (SICADOC) com baixa parcial, precisaremos de 2 (dois) registros um o
valor já pago e outro com o valor em aberto (ainda devido).
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
6
www.sicacred.com.br
EXEMPLO DE ROTINA PARA PREENCHIMENTO DAS TABELAS
1. Usuário informa o Código da Fonte e um Período (Data Inicial e Data Final) OU utiliza o
método ConsultadaDatas para pegar a SUGESTÃO MÍNIMA de Data Inicial. A Data Final
deverá ser geralmente o Dia que se estar gerando as informações.
2. LER TODOS os clientes da FONTE e SELECIONAR os CLIENTES que tiverem:
a) Alguma Compra À PRAZO com Data  >= DataInicial E  <= DataFinal; OU
b) Algum Documento Financeiro À PRAZO com Data de Pagamento (Pagto. Mais
Recente) >= DataInicial E <= DataFinal; OU
c) Algum Documento em Aberto com Data de EMISSÃO <= DataFinal.
3. Para CADA cliente selecionado (Item 2), deverá:
a) Inserir OU Atualizar TODAS as informações deste na tabela SICACLI;
b) Excluir na tabela SICACPR as compras deste cliente que estejam dentro do intervalo
(Data Inicial e Final) informado pelo usuário no item 1;
c) Importar para a tabela SICACPR todas as compras (a vista ou a prazo) deste cliente
que estejam dentro do intervalo período informado;
d) Excluir na tabela SICADOC os documentos PAGOS deste cliente que estejam COM
DATA DE PAGAMENTO dentro do intervalo (Data Inicial e Final) informado pelo
usuário no item 1;
e) Excluir na tabela SICADOC TODOS os documentos EM ABERTO COM Data de
EMISSÃO <= Data Final informada pelo usuário no item 1;
f) Importar para a tabela SICADOC os documentos financeiros À PRAZO PAGOS deste
cliente que estejam COM DATA DE PAGAMENTO dentro do intervalo (Data Inicial e
Final) informado pelo usuário no item 1;
g) Importar para a tabela SICADOC os documentos EM ABERTO deste cliente COM
Data de EMISSÃO <= Data Final.
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
7


SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845   e-mail:sac@grnegocios.com.br  www.sicacred.com.br
8
EXEMPLO PARA SERIALIZAÇÃO DOS OBJETOS PARA ENVIO VIA JSON

1. Aplicação utiliza o método ConsultadaDatas para pegar a SUGESTÃO MÍNIMA de Data
Inicial. A Data Final deverá ser geralmente o Dia que se estar gerando as informações.
2. Selecionar SOMENTE os CLIENTES que tiverem:
a) Alguma Compra À PRAZO com Data  >= DataInicial E  <= DataFinal; OU
b) Algum Documento Financeiro À PRAZO com Data de Pagamento (Pagto. Mais
Recente) >= DataInicial E <= DataFinal; OU
c) Algum Documento em Aberto com Data de EMISSÃO <= DataFinal.
3. Para CADA cliente selecionado (Item 2), deverá:
a) Preparar um objeto com TODAS as informações deste referente ao objeto
SICACLI;
b) Preparar um objeto SICACPR com as compras (à vista ou à prazo) deste cliente
que estejam dentro do período informado;
c) Preparar um objeto SICADOC com os títulos À PRAZO PAGOS deste cliente que
estejam COM DATA DE PAGAMENTO dentro do intervalo (Data Inicial e Final)
informado pelo usuário no item 1;
d) Preparar um objeto SICADOC com os títulos EM ABERTO deste cliente COM Data
de EMISSÃO <= Data Final.

OBSERVAÇÕES GERAIS
Os campos do TIPO DATA, devem vir no formato yyyy-DD-mm.
Exemplos:
  "SicaPrm":  "DT_ATU":"2023-10-20",  "DT_INI":"2023-10-01",  "DT_FIM":"2023-10-20",

"SicaCli": "DT_CAD":"2005-04-24",

"SicaCpr": "DT_CPR":"2023-10-03",

    "SicaDoc":[
        {
            "DT_EMI":"2023-07-20",
            "DT_VENC":"2023-08-20",
            "DT_PGTO":"2023-10-10",
DOCUMENTAÇÃO ACESSO WEB API PARA ENVIO VIA JSON
1. ACESSO
URL BASE:  https://sicacred.com.br:7076/api/
2. AUTENTICAÇÃO
Caso o cliente faça a opção de se comunicar via web, então é necessário que o cliente possua uma Conta
GR e Chave de Acesso válidos nas bases de dados da GR Negócios, com permissão de acesso à "web
api"; o mecanismo de autenticação utiliza o padrão HTTP Bearer Authentication.
Bearer
Content-Type: application/json
Authorization: Bearer SEU_TOKEN_AQUI
Apenas clientes com token de acesso válido terá permissão de comunicação direta com os endpoints da
webapi.
A cada requisição é preciso enviar no cabeçalho (header) o token válido recebido pela própria webAPI
durante a autenticação.
Fluxo: - Obter um Token - Fazer um request enviando o Token - Retornar o resultado da requisição
Para obter o token acesse “URLBASE/api/gettoken, enviado as seguintes informações:




grant_type: password
username: Código da Conta GR (Grupo Empresa)
codigoerp: Código do Sistema de Gestão\Envio dentro da GR
password: Chave de Acesso fornecida pela GR
Caso as informações acima sejam validadas pelo servidor, o cliente receberá o token válido que será
preciso enviar no “header” em cada requisição aos endpoints da web api.
Exemplo:
grant_type=password&username={grupoEmpresa}&codigoerp={codErp}&password={chave}
Acesse: https://sicacred.com.br/Suporte/Integracao para baixar o código fonte de uma aplicação C#.
Nela temos a “GR.SicaIntegracaoApp” com exemplo feito para ENVIO das informações para o SICACRED
via JSON e temos a “” com exemplo para consulta de dados.
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
9
3. OPERAÇÕES
* Método “ConsultaDatas” - EndPoint: URLBASE/SicaIntegration/ConsultaDatas
Enviar preenchido objeto “DtoSicaConsultaDatas” para recuperar: a data do último envio, Data
INICIAL para selecionar as informações para geração\envio e Quantidade de Dias em Atraso
no envio.  - Objeto de Envio:
*DtoSicaConsultaDatas

Atributos:
CodFonte = código da Fonte (Código SICA) a ser consultada;



CodGrpEmp = código grupo empresa a ser consultado;
Chave= chave do grupo empresa a ser consultada;
Producao = informar se vai se comunicar com o ambiente de produção ou não (campo
boleano – false ou true). - Objeto de Retorno:
*SicaConsultaDatasResponse
Atributos:


MensagemRetorno = Mensagem de retorno da consulta;
CodigoRetorno = Código de retorno da consulta (100: com sucesso, 0: insucesso).
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
10
www.sicacred.com.br



DataEnvioArquivo = Data de envio da informação (DATA MÍNIMA SUGERIDA PARA ESTAR
GERANDO AS INFORMAÇÕES)
DatUltArquivo = Data do último arquivo\envio
AtrasoLib = Dias de atraso (SE MAIOR OU IGUAL A 7 DIAS, ENTÃO ENVIAR AS
INFORMAÇÕES)
* Método “PostFile” - EndPoint: URLBASE/SicaIntegration/PostFile
Enviar preenchido objeto “DtoSicaIntegrator” de acordo com o exemplo que temos nesse manual. - Objeto de Envio:
DtoSicaIntegrator
Atributos:


SicaPrm = referente a tabela SICAPRM;
SicaCli = referente a tabela\visão SICACLI (Lista de SicaCLi);
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
11





SicaCpr = referente a tabela\visão SICACPR (Lista de SicaCpr);
SicaDoc = referente a tabela\visão SICADOC (Lista de SicaDoc);
SicaFmp = referente a tabela SICAFmp (Lista de SicaFmp);
SicaFmpMap = referente a tabela SICAFmpMap (Lista de SicaFmpMap);
Producao = informar se vai se comunicar com o ambiente de produção ou não (campo
boleano – false ou true). - Objeto de Retorno:
*SicaIntegracaoResponse
Atributos:


MensagemRetorno = Mensagem de retorno da integração;
CodigoRetorno = Código de retorno da integração (100: com sucesso, 0: insucesso).
4. DADOS DE CONFIGURAÇÃO PARA O AMBIENTE DE HOMOLOGAÇÃO
 Producao: false
 CodFonte: CSL1704
 CodGrpEmp: 2018004
 Chave: 2504aa84-d511-4154-b877-f403c1d7
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
12
www.sicacred.com.br
SICACRED – Serviço de Informação de Cadastro Atacadista
Fone : (85)  3087-4845
e-mail:sac@grnegocios.com.br
www.sicacred.com.br
13