Documento de Integração Seedz

Entidade: CLIENTE
Entidade destinada ao envio de informações cadastrais do cliente/consumidor da
empresa. Cliente este que será vinculado nos documentos de venda, pedido e etc.

Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDados Texto Obrigatório CNPJ da empresa detentora dos dados.

dataCadastro dd-mm-yyyy hh:mm:ss Obrigatório Data de cadastro do registro

Data da última atualização do cadastro

dataAtualizacao dd-mm-yyyy hh:mm:ss Obrigatório
do registro

id Numérico Obrigatório Código único do cliente cadastrado

razaoSocial Texto Obrigatório Razão social do cliente cadastrado

Número do documento do cliente:

° CNPJ - Se for Pessoa jurídica
documento Numérico Obrigatório
° CPF - Se for Pessoa física
OBS.: Considerar apenas os números.

Número do celular do cliente

celular Numérico Obrigatório cadastrado
OBS.: Considerar apenas os números.

email Texto Obrigatório E-mails do cliente

Entidade: PROPRIEDADE
Entidade destinada a informar o cadastro de Propriedades (Fazenda, Galpão, Centro de
Distribuição etc.), que sejam vinculadas à um Cliente cadastrado.

Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDados Texto Obrigatório CNPJ da empresa detentora dos

 dados.

id Numérico Obrigatório Código único da propriedade

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do

dataAtualizacao Obrigatório
hh:mm:ss cadastro do endereço.

Código único do cliente da

idCliente Numérico Obrigatório
propriedade no cadastrado

razaoSocial Texto Obrigatório Razão social da propriedade.

cnpj Texto Obrigatório CNPJ da propriedade.

Considerações:
1. O cliente poderá ser cadastrado sem propriedades vinculadas. As propriedades do cliente
serão cadastradas apenas quando todos os itens obrigatórios da seção propriedade for
enviado na integração.

Entidade: ITEM
Entidade destinada ao cadastro de Produto Acabado, onde o mesmo poderá ser utilizado
posteriormente para vínculo nos Pedidos de Venda e Faturamento.

Dados
Campo Tipo Obrigatoriedade Descrição

CNPJ da empresa detentora dos

cnpjOrigemDados Texto Obrigatório
dados.

Código único do produto

id Numérico Obrigatório
cadastrado.

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do

dataAtualizacao Obrigatório
hh:mm:ss registro

sku Texto Obrigatório Código SKU do produto cadastrado.

descricao Texto Obrigatório Nome do produto cadastrado.

Entidade: PEDIDO
Entidade onde serão informados os dados que compõem o cabeçalho dos Pedidos de
Venda (Pré-Venda).

Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDadosPedido Texto Obrigatório CNPJ da empresa detentora dos dados.

id Numérico Obrigatório Código do pedido de venda aprovado

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do cadastro do

dataAtualizacao Obrigatório
hh:mm:ss registro

dataEmissao dd-mm-yyyy Obrigatório Data de emissão do pedido de venda.

Indica a situação do pedido de venda.

° 0 - Pendente de faturamento
status Numérico Obrigatório ° 1 - Faturado
° 2 - Cancelado
° 3 - Venda Perdida

Código identificador único do cadastro de

idCliente Numérico Obrigatório
cliente

Documento do cliente do pedido de venda.

documentoCliente Numérico Obrigatório ° CNPJ - Pessoa física.
° CPF - Pessoa jurídica.

documentoEmpresa Numérico Obrigatório Número do CNPJ da empresa da venda.

vendedor1 Numérico Obrigatório Código do vendedor responsável 1 pela venda.

Entidade: PEDIDOITEM
Entidade cujos dados listam os produtos, quantidade e valores que compõem um Pedido
de Venda (Pré-Venda).
Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDados Texto Obrigatório CNPJ da empresa detentora dos dados.

id Numérico Obrigatório Código do produto pedido, identificador único

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do cadastro do

dataAtualizacao Obrigatório
hh:mm:ss registro

idPedido Numérico Obrigatório Código do pedido de venda

dataEmissao dd-mm-yyyy Obrigatório Data do pedido de venda.

Indica a situação do produto pedido de venda.

° 0 - Pendente de faturamento
status Numérico Obrigatório ° 1 - Faturado
° 2 - Cancelado
° 3 - Venda Perdida

Documento do cliente do pedido de venda.

documentoCliente Numérico Obrigatório ° CNPJ - Pessoa jurídica.
° CPF - Pessoa física.

idItem Numérico Obrigatório Código único do produto do pedido de venda.

skuItem Numérico Obrigatório Código SKU do produto do pedido de venda.

descricaoItem Texto Obrigatório Descrição do produto no pedido de venda.

Unidade de medida do produto do pedido de

unidMedidaItem Texto Obrigatório
venda.

qtd Numérico Obrigatório Quantidade do produto no pedido de venda.

Valor de tabela do produto, definido do na

valorUnitLiq Numérico Obrigatório
hora da venda. (Sem desconto).

valorTotal Numérico Obrigatório Valor total dos produtos.

Entidade: FATURAMENTO
Entidade onde deverão ser informados os dados referente ao cabeçalho da
Venda/Devolução de produto.
Dados
Campo Tipo Obrigatoriedade Descrição

CNPJ da empresa detentora dos

cnpjOrigemDadosFaturamento Texto Obrigatório
dados.

dd-mm-yyyy
dataCadastroFaturamento Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do

dataAtualizacaoFaturamento Obrigatório
hh:mm:ss cadastro do registro

Código do faturamento,
id Texto Obrigatório
identificador único

Código identificador único do

idCliente Numérico Obrigatório
cadastro de cliente

Número do documento do cliente:

° CNPJ - Se for Pessoa jurídica
documentoCliente Numérico Obrigatório
° CPF - Se for Pessoa física
Considerar apenas os números.

Número da Nota Fiscal do

numeroNfFaturamento Numérico Obrigatório
faturamento

serieNfFaturamento Texto Obrigatório Seria da Nota Fiscal do faturamento

Código Fiscal de Operação (CFOP) da

cfop Texto Obrigatório
nota fiscal do faturamento

dtEmissaoFaturamento dd-mm-yyyy Obrigatório Data de emissão da Nota Fiscal

Situação da transmissão da Nota

Fiscal na SEFAZ:
° Concluída
statusNfFaturamento Texto Obrigatório
º Pendente
º Cancelada
° Denegada

Valor total referente aos produtos

vlrTotalProdutosFaturamento Numérico Obrigatório
faturados na nota fiscal

vlrTotalNfFaturamento Numérico Obrigatório Valor total da nota fiscal faturada

Entidade: FATURAMENTOITEM
Entidade onde deverão ser informados os itens, quantidades e valores em documentos de
Venda/Devolução de produtos comercializados.
Dados
Campo Tipo Obrigatoriedade Descrição

CNPJ da empresa detentora dos

cnpjOrigemDados Texto Obrigatório
dados.

Código único do cadastro da nota

Id Numérico Obrigatório
fiscal (PK)

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy Data da última atualização do

dataAtualizacao Obrigatório
hh:mm:ss cadastro do registro

Numero Numérico Obrigatório Número da nota fiscal

Serie Numérico Obrigatório Serie da nota fiscal

dataEmissao dd-mm-yyyy Obrigatório Data de emissão da nota fiscal.

Código único do pedido de venda

idPedido Numérico Obrigatório
vinculado a nota fiscal.

Código do tipo de nota fiscal.

Tipo Numérico Obrigatório 0 - Nota de entrada.
1 - Nota de saída.

Identificador único do cadastro de

idCliente Numérico Obrigatório
cliente

Código único da nota fiscal de saída

(PK) referente aos produtos
idNotaFiscalOrigem Numérico Não obrigatório devolvidos.
Deverá ser preenchido quando o
campo idTipoNotaFiscal for igual a 0.

Número da nota fiscal de saída

referente aos produtos devolvidos.
notaFiscalOrigem Numérico Não obrigatório
Deverá ser preenchido quando o
campo idTipoNotaFiscal for igual a 0.

Código único do produto (PK) da

idItem Numérico Obrigatório
nota fiscal.

descricaoItem Texto Obrigatório Descrição do produto.

skuItem Numérico Obrigatório Código SKU do produto.

Unidade de medida do produto da

unidadeMedidaItem Texto Obrigatório
nota fiscal.
 quantidadeItem Numérico Obrigatório Quantidade do produto.

Valor unitário (fechado, já com os

valorUnitarioItem Numérico Obrigatório
descontos aplicado).

Valor total do produto (Quantidade

valorTotalItem Numérico Obrigatório
x Valor unitário).

Entidade: CONTASRECEBER
Entidade cujas informações são referentes aos títulos financeiros do contas a receber,
originados de vendas realizadas para Clientes.

Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDados Texto Obrigatório CNPJ da empresa detentora dos dados.

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy
dataAtualizacao Obrigatório Data da última atualização do registro
hh:mm:ss

Código único do cadastro do contas a receber

id texto Obrigatório
(PK)

titulo texto Obrigatório Identificador único do título no financeiro

idCliente Numérico Obrigatório Código de identificador único do cliente

nomeCliente Texto Obrigatório Razão Social ou Nome do cliente

dataEmissao dd-mm-yyyy Obrigatório Data de emissão do título

Número do documento de saída o qual deu

documento texto Obrigatório
origem ao título

Número do documento de saída o qual deu

serie texto Obrigatório
origem ao titulo

dtVencimentoOriginal dd-mm-yyyy Obrigatório Data de vencimento original do título

Data de vencimento alterada, caso exista

dtVencimentoProrrogado dd-mm-yyyy Obrigatório necessidade de prorrogação ou antecipação.
Ou seja, trata-se da data real.
 Valor líquido do título.
Trata-se do valor original do título, acrescido
vlrLiquido Numérico Obrigatório dos valores adicionais (vlrAcrescimos) e
deduzido dos valores de descontos
(vlrDescontos).

Situação do título indicando o estado do título

em caixa, utilizando uma das seguintes
opções:
° Aberto
situacao Texto Obrigatório ° Liquidado
° Atrasado
° Protestado
° Devolvido
° Cobrança

Data a qual o título foi baixado (pago).

OBS.: Este campo só deve possuir informação
dtBaixa dd-mm-yyyy Obrigatório
caso o campo "situação" esteja com valor
"Liquidado"

idVendedor1 Numérico Obrigatório Código de identificação único do vendedor 1

Entidade: VENDEDOR
Entidade com informações cadastrais dos vendedores de Produtos/Serviços de itens
comercializados pela empresa.

Dados
Campo Tipo Obrigatoriedade Descrição

cnpjOrigemDados Texto Obrigatório CNPJ da empresa detentora dos dados.

dd-mm-yyyy
dataCadastro Obrigatório Data de cadastro do registro
hh:mm:ss

dd-mm-yyyy
dataAtualizacao Obrigatório Data da última atualização do registro
hh:mm:ss

id Numérico Obrigatório Identificador chave do cadastro de Vendedor

Número de documento CPF ou CNPJ do

documento Numérico Obrigatório Vendedor
OBS.: Apenas números
razaoSocial Texto Obrigatório Razão Social do Vendedor

Número do celular do Vendedor com DDD

celular Numérico Não obrigatório
Considerar apenas os números.

email texto Não obrigatório E-mail do Vendedor