Você está na página 1de 9

Integração CorpEM/ERP X CorpEM/WMS

Processos de integração:
01 - Integração Cadastro de Mercadorias (Fluxo das informações: ERP => WMS)
02 - Integração NF de entrada (DP de entrada) (Fluxo das informações: ERP => WMS)
03 - Integração Termo de Falta Avaria do recebimento (Fluxo das informações: WMS => ERP)
04 - Integração de Pedido de Saída (DP Saída) (Fluxo das informações: ERP => WMS)
05 - Integração da Confirmação de Separação (Fluxo das informações: WMS => ERP)
06 - Integração da Nota fiscal de saída (Fluxo das informações: ERP => WMS)

PROGRAMAR SEMPRE O RECEBEDOR DOS DADOS

01 - Integração Cadastro de Mercadorias

Fluxo de dados:
Sentido: ERP para CorpEM (WMS)

Campos:
Cabeçalho:
CODPROD = Código da Mercadoria (que será utilizado para identificar os produtos nas integrações)
NOMEPROD = Código de fábrica + Descrição da mercadoria
IWS_ERP = Indicador WMS/ERP
TPOLRET = vazio
IAUTODTVEN = vazio
QTDDPZOVEN = vazio
ILOTFAB = Indicador controle de lote fabricação
IDTFAB = Indicador controle data fabricação
IDTVEN = Indicador controle data vencimento
INSER = Indicador controle número série
CODFAB = Código do Fabricante
NOMEFAB = Nome Fabricante

Embalagens (Mercadoria pode possuir uma ou mais embalagens):


CODUNID = Embalagem (Ex: UN - unidade, PC - Peça, CX - Caixa.)
FATOR = Quantidade da mercadoria na embalagem (opcional)
CODBARRA = Código de barras
PESOLIQ = Peso Líquido (opcional)
PESOBRU = Peso Bruto (opcional)
ALT = Altura (opcional)
LAR = Largura (opcional)
COMP = Comprimento (opcional)
VOL = Volumetria / Cubagem (opcional)

Exemplo JSON (Mercadoria):


{
"CORPEM_ERP_MERC": {
"CGCCLIWMS": "35457333000129",
"PRODUTOS": [
{
"CODPROD": "1003",
"NOMEPROD": "SORO FISIOLOGICO 0,9% 250ML FR SISTEMA FECHADO - EUROFARMA",
"IWS_ERP": "1",
"TPOLRET": "1",
"IAUTODTVEN": "0",
"QTDDPZOVEN": "",
"ILOTFAB": "0",

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 1
"IDTFAB": "0",
"IDTVEN": "0",
"INSER": "0",
"CODFAB": "",
"NOMEFAB": "",
"EMBALAGENS": [
{
"CODUNID": "FR",
"FATOR": "1",
"CODBARRA": "7898919447428",
"PESOLIQ": "",
"PESOBRU": "",
"ALT": "",
"LAR": "",
"COMP": "",
"VOL": ""
}
]
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Muitas embalagens (loop)”
Mensagem erro: “078 - Nenhuma Embalagem informada”
Mensagem erro: “077 - Nenhuma Mercadoria informada”

02 - Integração NF de entrada (DP de entrada)

Fluxo de dados:
Sentido: ERP para CorpEM (WMS)

Campos:
Cabeçalho:

CGCCLIWMS = CNPJ do cliente WMS (Filial que irá receber a mercadoria)


CGCREM = CGC Remetente
OBSRESDP = Observação resumida do DP ( Nome Fornecedor + CGC Remetente)
TPDESTNF = Ver detalhamento no tópico abaixo (Informações adicionais do Tipo Destinatário N.F)
DEV = Indica se a nota fiscal é de devolução ou não (1 NOTA DE DEVOLUÇÃO , 0 NOTA NORMAL)
NUMNF = Número da nota fiscal
SERIENF = Série da nota fiscal
DTEMINF = Data de emissão da Nota fiscal
VLTOTALNF = Valor total da nota fiscal
NUMEPEDCLI = Número do pedido (deve ser único)
CHAVENF = Chave da nota fiscal eletrônica

Itens:
NUMSEQ = Número de sequência no item da nota fiscal
CODPROD = Código do produto
QTPROD = Quantidade do produto
VLTOTPROD = Valor total do produto (item da nota fiscal)
NUMPED_COMPRA = Número do Pedido de Compra (Conteúdo Opcional)

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 2
Informações adicionais do Tipo Destinatário N.F
Tipo Destinatário N.F.
. Os campos "Tipo Dest. N.F." e "CNPJ Remetente N.F." são opcionais.
. Se informados, o sistema não permitirá mais de 1 N.F. com os mesmos "CNPJ Emitente" / "No. N.F." / "Série".
. O "CNPJ Remetente N.F." poderá estar ou não cadastrado.

Armazém - (1)
. A N.F. é destinada ao Armazém e emitida pelo Cliente WMS.
. O Remetente N.F. é o Cliente WMS.
. Exemplo: Remessa p/ Armazenagem (apenas Operadores Logísticos).

Cliente - Normal - (2)


. A N.F. é destinada ao Cliente WMS e emitida por Teceiros.
. O Remetente N.F. é o Terceiro.
. Exemplos: Compras, Transferências e Devoluções emitidas por Terceiros.

Cliente - Entrada - (3)


. A N.F. é destinada ao Cliente WMS e emitida pelo próprio Cliente WMS.
. O Remetente N.F. é o Terceiro.
. Exemplos: N.F. Importação e Devoluções emitidas pelo próprio Cliente WMS.

Exemplo JSON (NF de Entrada):


{
"CORPEM_ERP_DOC_ENT": {
"CGCCLIWMS": "35457333000129",
"CGCREM": "94516671000153",
"OBSRESDP": "N.F.: 459607",
"TPDESTNF": "2",
"DEV": "0",
"NUMNF": "459607",
"SERIENF": "2",
"DTEMINF": "17/03/2020",
"VLTOTALNF": "250",
"NUMEPEDCLI": "N.F. 459607",
"CHAVENF": "43190394516671000153550020004596071023377876",
"ITENS": [
{
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "100",
"VLTOTPROD": "100"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "100",
"VLTOTPROD": "150"
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Muitas mercadorias (loop)” (Mais de 10.000 Mercadorias)
Mensagem erro: “077 - Nenhuma Mercadoria informada”

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 3
03 - Integração TFA do recebimento NF

Fluxo de dados:
Sentido: CorpEM (WMS) para ERP

Campos:
Cabeçalho:
CHAVE_NFE = Chave da nota fiscal eletrônica importada na integração "02 - Integração NF de Entrada DP de
Entrada"

Itens:
NUMSEQ = Número sequencial do item
CODPROD = Código do produto
QTPROD = Quantidade total do produto
QTAVARIA = Quantidade de avarias no recebimento
QTFALTA = Quantidade de faltas no recebimento
LOTFAB = Quantidade lote fabricação (Conteúdo Opcional)
DTFAB = Quantidade data fabricação (Conteúdo Opcional)
DTVEN = Quantidade data vencimento (Conteúdo Opcional)
NSER = Quantidade número série (Conteúdo Opcional)

Exemplo JSON (TFA do recebimento NF):


{
"CORPEM_WMS_FECHA_DE": {
"CHAVENFE": "43190394516671000153550020004596081023377806",
"ITEMS": [
{
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "0",
"QTAVARIA": "0",
"QTFALTA": "10",
"LOTFAB": "011949194 *** Falta/Recebimento",
"DTFAB": "01/01/1970",
"DTVEN": "01/01/1970"
},
{
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "90",
"QTAVARIA": "0",
"QTFALTA": "0",
"LOTFAB": "lote1",
"DTFAB": "01/01/2001",
"DTVEN": "01/01/2020"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "80",
"QTAVARIA": "0",
"QTFALTA": "0",
"LOTFAB": "lote3",
"DTFAB": "02/02/2002",
"DTVEN": "02/02/2022"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "0",
"QTAVARIA": "10",
"QTFALTA": "0",

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 4
"LOTFAB": "lote2",
"DTFAB": "02/02/2002",
"DTVEN": "02/02/2022"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "0",
"QTAVARIA": "0",
"QTFALTA": "10",
"LOTFAB": "011949195 *** Falta/Recebimento",
"DTFAB": "01/01/1970",
"DTVEN": "01/01/1970"
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Fechamento Tag XXXXX não encontrado (loop)”
Mensagem erro: “Bloqueio Avaria Recebimento" não definido - favor rever tela WW1 [ERP]”
Mensagem erro: “Bloqueio Falta Recebimento" não definido - favor rever tela WW1 [ERP]”
Mensagem erro: “Chave NF-e Recebida não encontrada:”
Mensagem erro: “Doca Recebimento Padrão" não definida - Rever tela LAG [ERP]”
Mensagem erro: “D.P. possui mais de 1 Doc. Entrada no ERP. Chave NF-e:”
Mensagem erro: “Ítem Doc. Entrada não encontrado. NUMSEQ: 9 - Chave NF-e:”
Mensagem erro: “Tag CODPROD não encontrada. NUMSEQ:”
Mensagem erro: “CODPROD diverge do Cód. Merc. do Ítem Doc. Entrada. CODPROD: XXXXX - Cód.
Merc.: YYYYY - Chave NF-e:”
Mensagem erro: “Controle Lote Fabr. divergente. Cód Merc.:”
Mensagem erro: “Controle Dt. Fabr. divergente. Cód Merc.:”
Mensagem erro: “Controle Dt. Venc. divergente. Cód Merc.:”
Mensagem erro: “Controle No. Série divergente. Cód Merc.:”
Mensagem erro: “Muitas mercadorias (loop)” (Mais de 10.000 Mercadorias)
Mensagem erro: “077 - Nenhuma Mercadoria informada”

04 - Integração de Pedido de Saída (DP Saída)

Fluxo de dados:
Sentido: ERP para CorpEM (WMS).

Campos:
Cabeçalho:
CGCCLIWMS = CNPJ do cliente WMS (CNPJ do Armazém)
CGCEMINF = CNPJ Emitente da nota fiscal de venda
OBSPED = Observação do pedido (não é apresentada no romaneio de separação)
OBSROM = Observação apresentada no romaneio de separação
NUMPEDCLI = Numero do pedido
NUMPEDRCA = Numero pedido RCA
VLTOTPED = Valor total do pedido
CGCDEST = CNPJ Cliente (cliente do pedido)
NOMEDEST = Nome/Razão Social do cliente
CEPDEST = CEP do endereço de destino

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 5
UFDEST = UF do endereço de destino
IBGEMUNDEST = Código do IBGE referente ao município de destino
MUN_DEST = Município do endereço de destino
BAIR_DEST = Bairro do endereço de destino
LOGR_DEST = Logradouro do endereço de destino
NUM_DEST = Número do endereço de destino
COMP_DEST = Complemento do endereço de destino
TP_FRETE = Tipo do Frete [ CIF | FOB ]
CODVENDEDOR = Código do vendedor
NOMEVENDEDOR = Nome do vendedor
DTINCLUSAOERP = Data e hora (timestamp) da inclusão do pedido no ERP
DTLIBERACAOERP = Data e hora (timestamp) da liberação do pedido no ERP
DTPREV_ENT_SITE = Data de previsão de entrega do pedido
EMAILRASTRO = Email do cliente (para rastreamento)
DDDRASTRO = DDD do telefone do cliente para o rastreamento de pedidos
TELRASTRO = Telefone do cliente para rastreamento dos pedidos
NUMNF = Número da NF
SERIENF = Série NF
DTEMINF = Data emissão NF
VLTOTALNF = Valor Total NF
QTVOL = Quantidade de volumes
CHAVENF = Chave NF

Itens:
NUMSEQ = Número sequencial do item no pedido
CODPROD = Código do produto
QTPROD = Quantidade do item no pedido
LOTFAB = Lote de Fabricação

Exemplo JSON (Pedido de Saída):


{
"CORPEM_ERP_DOC_SAI": {
"CGCCLIWMS": "35457333000129",
"CGCEMINF": "35457333000129",
"OBSPED": "",
"OBSROM": "",
"NUMPEDCLI": "DC - 3",
"NUMPEDRCA": "",
"VLTOTPED": "23314.4",
"CGCDEST": "61391769000172",
"NOMEDEST": "ARISTON IND. QUIM. E FARM. LTDA",
"CEPDEST": "55660000",
"UFDEST": "SP",
"IBGEMUNDEST": "3550308",
"MUN_DEST": "São Paulo",
"BAIR_DEST": "T",
"LOGR_DEST": "RUA ADHERBAL STRESSER,",
"NUM_DEST": "84",
"COMP_DEST": "",
"TP_FRETE": "C",
"CODVENDEDOR": "RUDIMAR",
"NOMEVENDEDOR": "Rudimar (e-Commerce)",
"DTINCLUSAOERP": "26/03/2020",
"DTLIBERACAOERP": "26/03/2020",
"DTPREV_ENT_SITE": "",
"EMAILRASTRO": "",
"DDDRASTRO": "",
"TELRASTRO": "",
"NUMNF": "",
"SERIENF": "",
"DTEMINF": "",
"VLTOTALNF": "",
"QTVOL": "",
"CHAVENF": "",
"ITENS": [
{

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 6
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "10"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "2"
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Fechamento Tag XXXXX não encontrado (loop)”
Mensagem erro: “Muitas mercadorias (loop)” (Mais de 10.000 Mercadorias)
Mensagem erro: “077 - Nenhuma Mercadoria informada”

05 - Integração da Confirmação de Separação

Fluxo de dados:
Sentido: CorpEM (WMS) para ERP

CAMPOS:
Cabeçalho:
CGCCLIWMS = CGC Cliente WMS (CGC Armazém)
NUMPEDCLI = Número pedido cliente
QTVOL = Quantidade de volumes do pedido
CGCTRANSP = CGC da transportadora

Itens:
NUMSEQ = Número sequencial do item no pedido
CODPROD = Código do produto
QTPROD = Quantidade do produto no pedido
QTCONF = Quantidade do produto conferida no pedido
LOTFAB = Lote Fabricação (Conteúdo Opcional)
DTFAB = Data Fabricação (Conteúdo Opcional)
DTVEN = Data Vencimento (Conteúdo Opcional)
NSER = Número Série (Conteúdo Opcional)

Exemplo JSON (Confirmação de Separação):


{
"CORPEM_WMS_CONF_SEP": {
"CGCEMINF": "35457333000129",
"CGCCLIWMS": "35457333000129",
"NUMPEDCLI": "DC - 3",
"QTVOL": "2",
"CGCTRANSP": "",
"DTFIMCHECK": "26/03/2020",
"URLRAST": "",
"ITENS": [
{
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "10",
"QTCONF": "10",
"LOTFAB": "LAA",

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 7
"DTFAB": "01/01/2020",
"DTVEN": "01/01/2022"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "2",
"QTCONF": "2",
"LOTFAB": "b",
"DTFAB": "01/01/2020",
"DTVEN": "01/01/2030"
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Fechamento Tag XXXXX não encontrado (loop)”
Mensagem erro: “Pedido/Cliente não encontrado: CNPJ Cliente: 1111111111111 - No. Pedido: 99999999”
Mensagem erro: “Qt. Volumes não informada - No. Pedido: 999999”
Mensagem erro: “D.P. possui mais de 1 Doc. Entrada no ERP - No. Pedido: 999999”
Mensagem erro: “D.P. possui reserva no ERP - No. Pedido: 999999”
Mensagem erro: “Ítem Doc. Entrada não encontrado. NUMSEQ: 9 - No. Pedido: 999999”
Mensagem erro: “CODPROD diverge do Cód. Merc. do Ítem Doc. Saída. NUMSEQ: 9 - CODPROD: 999999 -
Cód. Merc.: 999999”
Mensagem erro: “Quantidade do Ítem Doc. Entrada divergente. NUMSEQ: 9 - No. Pedido: 999999”
Mensagem erro: “Controle Lote Fabr. divergente. Cód Merc.:”
Mensagem erro: “Controle Dt. Fabr. divergente. Cód Merc.:”
Mensagem erro: “Controle Dt. Venc. divergente. Cód Merc.:”
Mensagem erro: “Controle No. Série divergente. Cód Merc.:”
Mensagem erro: “Reserva WMS/ERP incompleta. NUMSEQ: 9 - Cód Merc.: 999999 - Lote: XXXX - Dt. Fabr.:
DD/MM/AA - Dt. Venc.: DD/MM/AA - No. Série: 999999 - Qt. Reserva: 9999 - Qt. Conf.: 9999”
Mensagem erro: “Muitas mercadorias (loop)” (Mais de 10.000 Mercadorias)
Mensagem erro: “077 - Nenhuma Mercadoria informada”
Mensagem erro: “Checkout WMS/ERP incompleto. NUMSEQ: 9”

06 - Integração da Nota Fiscal de Saída

Fluxo de dados:
Sentido: ERP para CorpEM (WMS)

CAMPOS:
Cabeçalho:
CGCCLIWMS = CNPJ Cliente WMS (CNPJ Armazém)
CGCEMINF = CNPJ emitente da NF
NUMPEDCLI = Número do pedido
NUMNF = Número da nota fiscal
SERIENF = Série da nota fiscal
DTEMINF = Data emissão da nota fiscal
VLTOTALNF = valor total da nota fiscal
QTVOL = Quantidade de volumes
CHAVE_NFE = Chave da Nota fiscal eletrônica

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 8
ITEMS:
NUMSEQ = Número sequencial do item
CODPROD = Código da mercadoria
QTPROD = Quantidade

Exemplo JSON (Nota Fiscal de Saída):


{
"CORPEM_ERP_CONF_NF": {
"CGCCLIWMS": "35457333000129",
"CGCEMINF": "35457333000129",
"NUMPEDCLI": "DC - 3",
"NUMNF": "5",
"SERIENF": "800",
"DTEMINF": "26/03/2020",
"VLTOTALNF": "23314.4",
"QTVOL": "2",
"CHAVENF": "32200335457333000129558000000000051676298190",
"ITENS": [
{
"NUMSEQ": "1",
"CODPROD": "5100",
"QTPROD": "10"
},
{
"NUMSEQ": "2",
"CODPROD": "5101",
"QTPROD": "2"
}
]
}
}

Response:
Mensagem OK: “CORPEM_WS_OK": "OK"”
Mensagem erro: “Fechamento Tag XXXXX não encontrado (loop)”

Todas as informações contidas neste documento são de propriedade exclusiva da CorpEM Sistemas Ltda. e seu uso é
regulado pela Lei 9.610/98 - Lei dos Direitos Autorais e pelo Contrato de Prestação de Serviços firmado entre a CorpEM
Sistemas Ltda. e seus Clientes. É proibido: copiar, reproduzir, traduzir, adaptar, modificar, alienar, vender, locar,
sublocar, ceder, ou transferir esta documentação, no todo ou em parte, sem prévia e expressa autorização da CorpEM
Sistemas Ltda.

OBSERVAÇÃO IMPORTANTE:
Todos cadastros do sistema CorpEM são de responsabilidade do cliente e deverão ser realizados
e mantidos por tal, cabendo a CorpEM Sistemas Ltda. prestar os esclarecimentos, orientações e
informações pertinentes que lhes forem solicitadas.

Caso haja alguma dúvida favor entrar em contato através dos canais abaixo:
Telefone: (27) 3024-2888
E-mail: suporte@corpem.com.br
Site: www.corpem.com.br

Data: 09/04/2020 - Autor: Wagner L. M. da Silva - Empresa: CorpEM Sistemas Ltda. - Versão do Documento: 1.5 9

Você também pode gostar