API de Integração ERP (Padrão) x WMS Senior
Este documento apresenta um conteúdo técnico. As parametrizações no sistema não serão abordadas aqui; para isso, acesse o link relacionado no final da página em "Veja também". De maneira detalhada, serão apresentadas as APIs disponíveis para integração padrão com o WMS Senior. Nosso sistema possui diferentes modelos de exportação, sendo necessário atenção ao modelo escolhido pelo sistema integrador. Vale ressaltar que, quando falamos de Integração com o WMS Senior, estamos falando de chamadas de cadastro à API WMS, e também de exportações que o WMS faz para os ERPs.
Para conectar com a nossa API, os desenvolvedores devem utilizar as seguintes informações em todas as integrações:
- Base URL: a URL base do servidor onde a API está hospedada.
- Headers Necessários: informações sobre os cabeçalhos que precisam ser enviados com cada requisição.
- Content-Type: application/json
- Apikey: {Token de acesso, gerado pelo próprio WMS Senior para autenticar as chamadas à nossa API}
- Formato de Dados: as APIs estão no modelo REST e trafegam dados no formato JSON.
Para cada endpoint, os desenvolvedores terão as seguintes informações:
- Endpoints
- Método HTTP
- Parâmetros de Requisição
- Códigos de Status HTTP que a API pode retornar
Para exportações, utilizamos o mecanismo de webhook, onde o Gestão de Armazenagem | WMS Senior se comunica com sistemas terceiros através do método POST. É necessário que o sistema terceiro forneça os dados necessários para essa comunicação (cadastro de webhooks).
Particularidades
Antes de definir quais integrações serão utilizadas para a operação, é necessário verificar como foi ou será realizada a configuração do WMS Senior. Em caso de dúvidas, favor entrar em contato com o suporte da WMS Senior.
Com o Gestão de Armazenagem | WMS Senior.
Funcionalidade | Versão | Referência |
---|---|---|
API de Integração ERP (Padrão) x WMS Senior | 8.12 |
Integrações Disponíveis
Comunicação
Para as exportações de dados do WMS Senior para o ERP, é necessário registrar um webhook (gancho), informando um endpoint (URL) para cada tipo de exportação (tipoIntegracao) desejada.
Response
{ "id": 0, "tipoIntegracao": "string", "url": "string" }
Request
{ "id": 0, "tipoIntegracao": "string", "url": "string" }
Response
No body returned for response
Request
Parâmetro {id} do gancho a ser buscado.
Reponse
{ "id": 0, "tipoIntegracao": "string", "url": "string" }
Request
{ "id": 0, "tipoIntegracao": "string", "url": "string" }
Response
Gancho alterado com sucesso.
Dados Cadastrais
Endpoint para a integração de entidades, responsável por cadastrar entidades do ERP no Gestão de Armazenagem | WMS Senior. A comunicação nesse endpoint é assíncrona, ou seja, no Response (da requisição de cadastro) é informado um número de protocolo que pode ser utilizado posteriormente para consultar o status (erro, sucesso, agendado) no Log de Integração.
Para esta integração, devido à possibilidade de receber múltiplas entidades, o payload pode se tornar bastante extenso. Portanto, recomendamos que cada requisição contenha no máximo 500 entidades. Isso visa otimizar o desempenho e a eficiência da transmissão de dados.
Request
[ { "codigoInterno": "", "pessoa": "", "cnpj": "", "inscrEstadual": "", "razaoSocial": "", "fantasia": "", "cep": "", "endereco": "", "bairro": "", "cidade": "", "estado": "", "telefone": "", "pais": "", "numero": "", "idEstrangeiro": "", "estrangeiro": "", "cpf": "", "rg": "", "tipoEntidade": "", "inscricaoSuframa": "", "cnpjDepositante": "", "complemento": "", "codEndereco": "", "codigoSorter": "", "endEntrega": "", "endCobranca": "", "ativo": "", "controleShelfLife": "", "valorShelfLife": "", "idIntegracaoErp": "", "telefone2": "", "agente": "", "sigla": "", "personalizacaoCab": [ { "chave": "", "valor": "" } ] } ]
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CODIGOINTERNO | Texto | Sim | 30 | Código interno da entidade | |
PESSOA | Texto | Sim | 1 | Tipo de pessoa (J ou F) | |
CNPJ | Texto | Não | 20 | 99.999.999/9999-99 | Se campo pessoa = J (jurídica) será obrigatório CNPJ da Entidade |
INSCRESTADUAL | Texto | Não | 20 | Inscrição estadual da entidade | |
RAZAOSOCIAL | Texto | Sim | 100 | Razão social da entidade | |
FANTASIA | Texto | Não | 100 | Nome fantasia da entidade | |
CEP | Texto | Não | 18 | CEP do endereço da entidade | |
ENDERECO | Texto | Sim | 100 | Endereço da entidade | |
BAIRRO | Texto | Não | 100 | Bairro do endereço da entidade | |
CIDADE | Texto | Sim | 60 | Cidade do endereço da entidade | |
ESTADO | Texto | Sim | 2 | Estado do endereço da entidade | |
TELEFONE | Texto | Não | 20 | Telefone da entidade | |
PAIS | Texto | Não | 40 | País do endereço da entidade | |
NUMERO | Texto | Não | 60 | Número do endereço da entidade | |
IDESTRANGEIRO | Texto | Não | 30 | Código de Identificação de um Cliente Estrangeiro | |
ESTRANGEIRO | Texto | Sim | 1 | Indica se a entidade é Estrangeira. Sim (S) - Não (N) | |
CPF | Texto | Não | 30 | 999.999.999-99 | Se campo pessoa = F será obrigatório CPF da Entidade |
RG | Texto | Não | 20 | RG da Entidade | |
TIPOENTIDADE | Texto | Sim | 40 | Tipo da entidade. exemplo: fornecedor, cliente, depositante, transportadora | |
INSCRICAOSUFRAMA | Texto | Não | 20 | Indica o Código na SUFRAMA (Superintendência da Zona Franca de Manaus) | |
CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ do Depositante que a entidade pertence |
COMPLEMENTO | Texto | Não | 60 | Complemento do endereço da Entidade | |
CODENDERECO | Numérico | Não | 12 | 999999999999 | Código do endereço da entidade do sistema integrador |
CODIGOSORTER | Texto | Não | 3 | Código da Entidade de Entrega no Sorter (sistema) | |
ENDENTREGA | Texto | Sim | 1 | Indica se o endereço é do tipo entrega. Sim (S) - Não (N) | |
ENDCOBRANCA | Texto | Sim | 1 | Indica se o endereço é do tipo cobrança. Sim (S) - Não (N) | |
ATIVO | Texto | Sim | 1 | Indica se a entidade está ativa no sistema. Sim (S) - Não (N) | |
CONTROLESHELFLIFE | Numérico | Não | 1 | Define a forma de utilização de Shelf-Life para expedição dos produtos. 0 - Não controla, 1 - Em dias corridos para o vencimento, 2 - Percentual da vida útil | |
VALORSHELFLIFE | Numérico | Não | 3 | Determina o valor usado para controlar Shelf-Life | |
IDINTEGRACAOERP | Texto | Sim | 50 | ||
TELEFONE2 | Texto | Não | 20 | Segundo telefone da entidade | |
AGENTE | Texto | Sim | 1 | Informação adicional da entidade. (N) Não (S) Sim | |
SIGLA | Texto | Não | 3 | Sigla da entidade. utilizada para filial |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CHAVE | Texto | Não | 50 | Campo de personalização | |
VALOR | Texto | Não | 4999 | Valor do campo de personalização |
Response
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Endpoint para a integração de produtos e embalagens, responsável por cadastrar produtos e embalagens do ERP no WMS Senior. A comunicação neste endpoint é assíncrona, ou seja, no Response (da requisição de cadastro) é informado um número de protocolo que pode ser utilizado posteriormente para consultar o status (erro, sucesso, agendado) no Log de Integração.
Para esta integração, devido à possibilidade de receber múltiplos produtos com diferentes tipos de embalagens, o payload pode se tornar bastante extenso. Portanto, recomendamos que cada requisição contenha no máximo 500 produtos. Isso visa otimizar o desempenho e a eficiência da transmissão de dados.
Request
[ { "idIntegracaoErp": "", "cgc": "", "codReferencia": "", "codigoInterno": "", "descr": "", "tipoProd": "", "cnpjFamilia": "", "subFamilia": "", "marca": "", "subMarca": "", "ativo": "", "cor": "", "manufaturado": "", "sazonal": "", "segregado": "", "prazoValidade": "", "prazoComercializacao": "", "prazoCritico": "", "subTipoProd": "", "ncm": "", "codInterno": "", "descrProd": "", "codTipoProd": "", "cest": "", "motivoIsencao": "", "codigoProdAnvisa": "", "precoMaximoConsumidor": 0, "codigoInmetro": "", "kitExpExplodida": "", "utilizakitscompletos": 0, "preCadastro": "", "codigoProdutoAnp": "", "descricaoProdutoAnp": "", "descrVoicePicking": "", "embalagens": [ { "idEmbERP": "", "codigoInterno": "", "barra": "", "descrReduzido": "", "descr": "", "apresentacao": "", "fatorConv": 0, "altura": 0, "largura": 0, "comprimento": 0, "unidadeVenda": "", "unidadeCompra": "", "lastro": 0, "qtdeCamada": 0, "pesoBruto": 0, "pesoLiquido": 0, "empMax": 0, "ativo": "", "caixaFechada": "", "controlaEstoque": "", "seqEmb": 0, "codInterno" :"", "descrReduzido2": "", "cnpjDepositante": "", "inscrEstadualDep": "" } ] } ]
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CGC | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CODREFERENCIA | Texto | Não | 60 | Código de Referência (Código do produto do fornecedor) | |
CODIGOINTERNO | Texto | Sim | 20 | Código Interno do Produto | |
DESCR | Texto | Sim | 80 | Descrição do Produto | |
TIPOPROD | Texto | Não | 40 | Tipo de Produto (LIVRO, Utensílios, Alimento...) | |
CNPJFAMILIA | Texto | Sim | 20 | 99.999.999/9999-99 | Família (CNPJ do Produtor) |
SUBFAMILIA | Texto | Não | 60 | Subfamília do Produto | |
MARCA | Texto | Não | 60 | Marca do Produto | |
SUBMARCA | Texto | Não | 60 | Submarca do Produto | |
ATIVO | Texto | Sim | 1 | (S)im / (N)ão | Produto Ativo |
COR | Texto | Não | 20 | Cor do Produto | |
MANUFATURADO | Texto | Não | 1 | (S)im / (N)ão | Produto Manufaturado |
SAZONAL | Texto | Não | 1 | (S)im / (N)ão | Produto Sazonal |
SEGREGADO | Texto | Não | 1 | (S)im / (N)ão | Produto Segregado |
PRAZOVALIDADE | Texto | Não | 10 | Prazo de Validade em meses. | |
PRAZOCOMERCIALIZACAO | Texto | Não | 10 | Prazo de Comercialização em meses. | |
PRAZOCRITICO | Texto | Não | 10 | Prazo Crítico em meses | |
SUBTIPOPROD | Texto | Não | 40 | Subtipo do produto | |
NCM | Texto | Sim | 8 | Código de NCM | |
CODINTERNO | Texto | Sim | 60 | Código Interno do Produto | |
DESCRPROD | Texto | Sim | 120 | Descrição do Produto | |
CODTIPOPROD | Texto | Não | 20 | Código Interno do Tipo de Produto | |
CEST | Texto | Não | 7 | Código CEST | |
CODIGOPRODANVISA | Texto | Não | 13 | Código anvisa do produto | |
PRECOMAXIMOCONSUMIDOR | Númerico | Não | 13 | 0000000000,00 | Preço máximo consumidor |
CODIGOINMETRO | Texto | Não | 20 | Código Inmetro do Produto | |
MOTIVOISENCAO | Texto | Não | 255 | Motivo da isenção da ANVISA. Para medicamento isento de registro na ANVISA deve informar o número da decisão que o isenta. | |
KITEXPEXPLODIDA | Texto | Não | 1 | (S)im / (N)ão | Indica se o material é um kit de expedição explodida. Verifique a tabela. |
UTILIZAKITSCOMPLETOS | Numérico | Não | 1 | 0-Não,1-Sim | Determina se os componentes do kit serão agrupados durante o armazenamento. |
DESCRVOICEPICKING | Texto | Não | 120 | Indica a descrição do produto que pode ser usada no Voice Picking |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
IDEMBERP | Texto | Sim | 500 | Identificador único da embalagem no erp. | |
CODIGOINTERNO | Texto | Sim | 60 | Código Interno do Produto na Empresa | |
BARRA | Texto | Sim | 20 | Código de Barras do Produto | |
DESCRREDUZIDO | Texto | Sim | 2 | Descrição Reduzida da Embalagem - UN, DP ou CX | |
DESCR | Texto | Sim | 80 | Descrição para Identificação da Embalagem | |
APRESENTACAO | Texto | Não | 20 | Apresentação da Embalagem - "12 x 200 gr" | |
FATORCONV | Numérico | Sim | 6 | 999 | Fator de Conversão (Qtde de Unidades por Caixa). Este campo possui o limite de 6 caracteres |
ALTURA | Numérico | Sim | 12 | 999999999999 | Altura em MM |
LARGURA | Numérico | Sim | 12 | 999999999999 | Largura em MM |
COMPRIMENTO | Numérico | Sim | 12 | 999999999999 | Comprimento em MM |
UNIDADEVENDA | Texto | Não | 1 | (S)im / (N)ão | Menor embalagem para Entrada de Mercadorias |
UNIDADECOMPRA | Texto | Não | 1 | (S)im / (N)ão | Menor embalagem de Saída de Mercadorias |
LASTRO | Numérico | Sim | 12 | 999999999999 | Total de Unidades em uma camada do Palete |
QTDECAMADA | Numérico | Sim | 12 | 999999999999 | Quantidade de Lastros do Palete |
PESOBRUTO | Numérico | Sim | 12 | 999999999999 | Peso Bruto em GR |
PESOLIQUIDO | Numérico | Sim | 12 | 999999999999 | Peso Líquido em GR |
EMPMAX | Numérico | Sim | 12 | 999999999999 | Empilhamento Máximo |
ATIVO | Texto | Sim | 1 | (S)im / (N)ão | Ativo |
CAIXAFECHADA | Texto | Não | 1 | S/N | Indica se é caixa fechada |
CONTROLAESTOQUE | Texto | Não | 1 | S/N | Indica se controla estoque |
SEQEMB | Numérico | Não | 10 | 999999999999 | Número da embalagem |
CODINTERNO | Texto | Sim | 60 | Código Interno do Produto na Empresa com maior precisão | |
DESCRREDUZIDO2 | Texto | Não | 6 | Descrição Reduzida da Embalagem – UN, CX, LITRO, etc. Caso este campo seja informado, o campo DESCRREDUZIDO será desconsiderado, e este será usado para o cadastro da embalagem. | |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ do Depositante |
INSCRESTADUALDEP | Texto | Não | 20 | Inscrição Estadual do Depositante |
Response
{ "headers": {}, "body": { "mensagem": "O campo Código Interno é obrigatório. O campo CGC é obrigatório. O campo CNPJFAMILIA é obrigatório. O campo ATIVO é obrigatório O campo Código Interno é obrigatório. O campo DESCR é obrigatório. O campo BARRA é obrigatório. O campo fatorConv é obrigatório. O campo altura é obrigatório. O campo largura é obrigatório. O campo BARRA é obrigatório. O campo pesoBruto é obrigatório. O campo pesoLiquido é obrigatório.", "protocolo": "434" }, "statusCode": "NOT_ACCEPTABLE", "statusCodeValue": 406 }
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Recebimento
Endpoint para a integração de Pedidos, Notas Fiscais ou Apontamentos de Produção, responsáveis pela integração do material a ser alocado no fluxo de Entrada no WMS Senior. A comunicação neste endpoint é assíncrona, ou seja, no Response (da requisição de cadastro) é informado um número de protocolo que pode ser utilizado posteriormente para consultar o status (erro, sucesso, agendado) no Log de Integração.
Request
{ "numPedido": "", "sequencia": "", "cnpjDepositante": "", "codigoInterno": "", "cnpjEmitente": "", "tipo": "", "descrOper": "", "cfop": "", "dataEmissao": "", "pessoaDestinatario": "", "codigoDestinatario": "", "nomeDestinatario": "", "fantasiaDestinatario": "", "cnpjDestinatario": "", "enderecoDestinatario": "", "numeroEndDestinatario": "", "complementoEndDestinatario": "", "bairroDestinatario": "", "cepDestinatario": "", "cidadeDestinatario": "", "telefoneDestinatario": "", "telefone2": "", "ufDestinatario": "", "inscricaoEstadualDestinatario": "", "inscricaoMunicipalDestinatario": "", "enderecoEntrega": "", "cidadeEntrega": "", "bairroEntrega": "", "ufEntrega": "", "cepEntrega": "", "cnpjEntrega": "", "inscricaoEstadualEntrega": "", "baseIcms": 0, "valorIcms": 0, "baseSubstituicao": 0, "valorSubstituicao": 0, "frete": 0, "seguro": 0, "despesasAcessorias": 0, "ipi": 0, "valorProdutos": 0, "valorTotal": 0, "nomeTransportadora": "", "cnpjTransportadora": "", "enderecoTransportadora": "", "numeroEndTransportadora": "", "bairroTransportadora": "", "cidadeTransportadora": "", "ufTransportadora": "", "cepTransportadora": "", "inscricaoEstadualTransportadora": "", "cifFob": "", "veiculo": "", "ufVeiculo": "", "qtde": 0, "especie": "", "marca": "", "numero": "", "pesoLiquido": 0, "pis": 0, "cofins": 0, "cs": 0, "ir": 0, "valorIss": 0, "valorServicos": 0, "geraFinanceiro": "", "tipoDocumento": "", "tipoCarga": "", "limiteCorte": 0, "paginaGeomapa": "", "numItens": 0, "tipoNf": "", "estado": "", "dataColeta": "", "dataAgendamento": "", "horaColeta": "", "pessoaEntrega": "", "codigoEntrega": "", "nomeEntrega": "", "fantasiaEntrega": "", "numeroEndEntrega": "", "complementoEndEntrega": "", "nomeRepresentante": "", "telefoneRepresentante": "", "cnpjUnidade": "", "fatura": "", "observacao": "", "estoqueVerificado": "", "chaveIdentificacaoExt": "", "classificacaoCliente": 0, "prioridade": "", "porcentagemCxFechada": 0, "chaveAcessoNFE": "", "cnpjTranspRedespacho": "", "nomeTranspRedespacho": "", "enderecoTranspRedespacho": "", "numeroEndTranspRedespacho": "", "bairroTranspRedespacho": "", "cidadeTranspRedespacho": "", "ufTranspRedespacho": "", "cepTranspRedespacho": "", "inscEstadualTranspRedespacho": "", "enderecoConsig": "", "cidadeConsig": "", "bairroConsig": "", "ufConsig": "", "cepConsig": "", "inscricaoEstConsig": "", "pessoaConsig": "", "codigoConsig": "", "razaoSocialConsig": "", "fantasiaConsig": "", "numeroEndConsig": "", "complementoEndConsig": "", "inscricaoEstEmitente": "", "codigoServicoTransportadora": "", "pickToLight": "", "roteiro": "", "codigoTipoPedido": "", "embarquePrioritario": "", "tipoRegimeTributacao": "", "seqEntrega": 0, "razaoSocialEmitente": "", "fantasiaEmitente": "", "codigoRetencao": "", "valorIcmsDesonerado": 0, "presencaComprador": "", "formaPagamento": "", "tipoEntrada": "", "barraSeparacao": "", "semanaRecebimento": "", "anoRecebimento": "", "semanaDisponibilizacao": "", "anoDisponibilizacao": "", "utilizaZPL": "", "codigoRastreio": "", "agrupadorPed": 0, "idOrdemTransSaida": 0, "codigoPaisDestinatario": "", "codigoServicoEtiquetaExterna": "", "observacaoSeparacao": "", "inscricaoEstadualDepositante": "", "idIntegracaoErp": "", "dataPagto": "", "numeroOrdemProducao": "", "idMovimento": "", "idNotaFiscal": 0, "cnpjConsig": "", "intCubometro": "", "dataPlanejamento": "", "faturamentoDoisMomentos": "", "dataFaturamento": "", "canalVenda": "", "janelaInicio": "", "janelaFim": "", "codigoTipoRecebimento": "", "protocoloNfe": "", "dataRecebimentoNfe": "", "personalizacaoItem": [ , { "chave": "", "valor": "", } ], "itens": [ { "codigoInterno": "", "numPedido": "", "cnpjDepositante": "", "cnpjEmitente": "", "sequencia": "", "tipo": "", "idSeq": "", "codigoIndustria": "", "descricaoProduto": "", "barraProduto": "", "classificacaoFiscal": "", "st": "", "quantidade": "", "valorUnitario": "", "valorTotal": "", "aliquotaICMS": "", "aliquotaIPI": "", "ipi": "", "valorDesconto": "", "porcentualDesconto": "", "desconto": "", "totalLiquido": "", "tipoProduto": "", "quantidadeAtendida": "", "idNotaFiscal": "", "numeroSerie": "", "tipoMaterial": "", "st3": "", "inscricaoEstEmitente": "", "dataVencimentoLote": "", "descricaoReduzida": "", "idItemERP": "", "valorICMSdesonerado": "", "codigoProdutoAnvisa": "", "precoMaximoConsumidor": "", "baseICMS": "", "valorICMS": "", "importacaoCobFiscal": "", "aliquotaPIS": "", "basePIS": "", "valorPIS": "", "aliquotaConfins": "", "baseConfins": "", "valorConfins": "", "origemProduto": "", "remessa": "", "notaFiscal": "", "serieNF": "", "tipoPTL": "", "tipoCaixaSep": "", "volumeCaixa": "", "mensagemCaixa": "", "codigoSetor": "", "motivoIsencao": "", "numeroOrdemCompra": "", "obsItemSeparacao": "", "itensConferenciaEspecifica": { "numeroNf": "", "serieNf": "", "lote": "", "dataValidade": "", "dataFabricacao": "", "codigoProduto": "", "quantidade": 0, "idSeq": 0, "idSeqCfe": 0 } } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
NUMPEDIDO | Texto | Não | 20 | Se for NOTA FISCAL campo NUMÉRICO, se for PEDIDO campo Alfanumérico | Número do Pedido |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S | |
DESCROPER | Texto | Sim | 100 | Descrição da Operação | |
CFOP | Texto | Não | 4 | CFOP(Código Fiscal de Operação) NÃO é obrigatório caso o CFOP padrão de importação esteja definido (caso contrário sua informação se torna obrigatório no envio da requisição). | |
DATAEMISSAO | Data | Sim | 10 | DD/MM/AAAA | Data da Nota Fiscal |
PESSOADESTINATARIO | Texto | Sim | 1 | Destinatário - Física = F / Jurídica = J | |
CODIGODESTINATARIO | Texto | Sim | 20 | Código do Destinatário | |
NOMEDESTINATARIO | Texto | Sim | 60 | Destinatário - Razão Social | |
FANTASIADESTINATARIO | Texto | Não | 60 | Destinatário - Nome Fantasia | |
CNPJDESTINATARIO | Texto | Sim | 20 | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Destinatário - CNPJ para PJ / CPF para PF |
ENDERECODESTINATARIO | Texto | Sim | 80 | Destinatário - Endereço | |
NUMEROENDDESTINATARIO | Texto | Não | 10 | Destinatário - Endereço Número | |
COMPLEMENTOENDDESTINATARIO | Texto | Não | 50 | Destinatário - Complemento, Caso esse campo possua mais que 50 caracteres deixa-lo vazio e usar o campo COMPLEMENTO_DEST | |
BAIRRODESTINATARIO | Texto | Sim | 50 | Destinatário - Bairro | |
CEPDESTINATARIO | Texto | Sim | 8 | 99999999 | Destinatário - CEP |
CIDADEDESTINATARIO | Texto | Sim | 40 | Destinatário - Cidade | |
TELEFONEDESTINATARIO | Texto | Sim | 20 | Destinatário - Telefone | |
TELEFONE2 | Texto | Não | 20 | Destinatário - Telefone adicional | |
UFDESTINATARIO | Texto | Sim | 2 | Destinatário - Estado | |
INSCRICAOESTADUALDESTINATARIO | Texto | Não | 20 | Destinatário - Inscrição Estadual | |
INSCRICAOMUNICIPALDESTINATARIO | Texto | Não | 20 | Destinatário - Inscrição Municipal | |
ENDERECOENTREGA | Texto | Não | 80 | Será obrigatório se houverem dados de entrega Entrega - Endereço | |
CIDADEENTREGA | Texto | Não | 40 | Será obrigatório se houverem dados de entrega Entrega - Cidade | |
BAIRROENTREGA | Texto | Não | 50 | Será obrigatório se houverem dados de entrega Entrega - Bairro | |
UFENTREGA | Texto | Não | 2 | Será obrigatório se houverem dados de entrega Entrega - Estado | |
CEPENTREGA | Texto | Não | 8 | 99999999 | Será obrigatório se houverem dados de entrega Entrega - CEP |
CNPJENTREGA | Texto | Não | 20 | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Será obrigatório se houverem dados de entrega Entrega - CNPJ ou CPF |
INSCRICAOESTADUALENTREGA | Texto | Não | 20 | Entrega - Inscrição Estadual | |
BASEICMS | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS |
VALORICMS | Numérico | Não | 12 | 000000000,00 | Valor ICMS |
BASESUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS Substituição |
VALORSUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Valor do ICMS Substituição |
FRETE | Numérico | Não | 12 | 000000000,00 | Valor do Frete |
SEGURO | Numérico | Não | 12 | 000000000,00 | Valor do Seguro |
DESPESASACESSORIAS | Numérico | Não | 12 | 000000000,00 | Outras Despesas Acessórias |
IPI | Numérico | Não | 12 | 000000000,00 | Valor Total do IPI |
VALORPRODUTOS | Numérico | Sim | 12 | 000000000,00 | Valor Total dos Produtos |
VALORTOTAL | Numérico | Sim | Não | 000000000,00 | Valor Total da Nota |
NOMETRANSPORTADORA | Texto | Sim | 60 | Transportadora - Razão Social | |
CNPJTRANSPORTADORA | Texto | Sim | 20 | 99.999.999/9999-99 | Transportadora - CNPJ |
ENDERECOTRANSPORTADORA | Texto | Sim | 80 | Transportadora - Endereço | |
NUMEROENDTRANSPORTADORA | Texto | Sim | 10 | Transportadora - Endereço Número | |
BAIRROTRANSPORTADORA | Texto | Sim | 50 | Transportadora - Bairro | |
CIDADETRANSPORTADORA | Texto | Sim | 40 | Transportadora - Cidade | |
UFTRANSPORTADORA | Texto | Sim | 2 | Transportadora - Estado | |
CEPTRANSPORTADORA | Texto | Sim | 8 | 99999999 | Transportadora - CEP |
INSCRICAOESTADUALTRANSPORTADORA | Texto | Sim | 20 | Transportadora - Inscrição Estadual | |
CIFFOB | Texto | Sim | 1 | Transportadora - Modalidade do Frete Por Conta: (1) Contratação do Frete por conta do Remetente (CIF), (2) Contratação do Frete por conta do Destinatário (FOB), (4) Contratação do Frete por conta de Terceiros, (5)Sem Ocorrência de Transporte, (6)Transporte Próprio por conta do Remetente e (7)Transporte Próprio por conta do Destinatário | |
VEICULO | Texto | Não | 20 | Transportadora - Placa do Veículo | |
UFVEICULO | Texto | Não | 2 | Transportadora - Estado | |
QTDE | Numérico | Não | 12 | 999999999999 | Transportadora - Quantidade |
ESPECIE | Texto | Não | 20 | Transportadora - Espécie | |
MARCA | Texto | Não | 20 | Transportadora - Marca | |
NUMERO | Texto | Não | 20 | Transportadora - Número | |
PESOLIQUIDO | Numérico | Sim | 12 | 999999999999 | Transportadora - Peso Líquido (gramas) |
PIS | Numérico | Não | 12 | 000000000,00 | PIS |
COFINS | Numérico | Não | 12 | 000000000,00 | COFINS |
CS | Numérico | Não | 12 | 000000000,00 | Contribuição Social |
IR | Numérico | Não | 12 | 000000000,00 | Imposto de Renda |
VALORISS | Numérico | Não | 12 | 000000000,00 | Valor do ISS |
VALORSERVICOS | Numérico | Não | 12 | 000000000,00 | Valor do Serviço |
GERAFINCEIRO | Texto | Não | 1 | Sim / Nao | Vai para o Acerto de Carga ou Não |
TIPODOCUMENTO | Texto | Não | 5 | Tipo Documento | Tipo do Documento Cobrança - Dinheiro = D / Cheque = C / Boleto = B / X = Bonificação / Outros = T |
TIPOCARGA | Texto | Não | 10 | Tipo da Carga - Produtos Refrigerados, Secos, Especiais | |
LIMITECORTE | Numérico | Não | 12 | 000000000,00 | Valor Mínimo para cancelar o pedido. |
PAGINAGEOMAPA | Texto | Não | 12 | 999999999999 | Página Geo Mapa ou Setor |
NUMITENS | Numérico | Sim | 12 | 000000000,00 | Quantidade de produtos distintos existentes no pedido/nota |
TIPONF | Texto | Sim | 1 | Pedido/Notafiscal | Indica se o Registro é um Pedido (P) ou uma Nota Fiscal (N) |
ESTADO | Texto | Não | 1 | Indica o estado do Pedido/NotaFiscal (N) Bom, (D) Danificado, (T) Truncado ou Vencido. | |
DATACOLETA | Data | Não | 10 | DD/MM/AAAA | Data prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. |
DATAAGENDAMENTO | Data | Não | 19 | DD/MM/AAAA HH:MM:SS | Indica a data agendada pelo destinatário para entrega do pedido/nota fiscal (Utilizado pelo RMS Senior) |
HORACOLETA | Hora | Não | 8 | HH24:MM:SS | Hora prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. |
PESSOAENTREGA | Texto | Não | 1 | F / J | Entidade de Entrega - Física = F / Jurídica = J |
CODIGOENTREGA | Texto | Não | 20 | Código da Entidade de Entrega | |
NOMEENTREGA | Texto | Não | 60 | Entidade de Entrega - Razão Social | |
FANTASIAENTREGA | Texto | Não | 60 | Entidade de Entrega - Nome Fantasia | |
NUMENDENTREGA | Texto | Não | 10 | Entidade de Entrega - Endereço Número | |
COMPLEMENTOENDENTREGA | Texto | Não | 50 | Entidade de Entrega - Complemento | |
NOMEREPRESENTANTE | Texto | Não | 60 | Nome do representante de vendas | |
TELEFONEREPRESENTANTE | Texto | Não | 20 | Telefone do representante de vendas | |
CNPJUNIDADE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Da Unidade de Armazenagem |
FATURA | Texto | Não | 50 | Texto livre | Condições de Pagamento |
OBSERVACAO | Texto | Não | 200 | Texto livre | Dados adicionais |
ESTOQUEVERIFICADO | Texto | Não | 1 | S / N / B | Indica se a nota fiscal vai verificar estoque ou não. "N" = Não Liberado / "B" = Bloqueado / "S" = Liberado |
CHAVEIDENTIFICACAOEXT | Texto | Não | 20 | Texto livre | Chave de identificação externa do documento |
CLASSIFICACAOCLIENTE | Numérico | Não | 12 | 999999999999 | Indica a classificação do Cliente para prioridade de liberação |
PRIORIDADE | Texto | Não | 1 | Indica a prioridade do valor do pedido. P, M, G | |
PORCENTAGEMCXFECHADA | Numérico | Não | 12 | 000000000,00 | Indica a porcentagem de caixa fechada para prioridade de liberação |
CHAVEACESSONFE | Texto | Não | 44 | Indica a chave de acesso da NFe. | |
CNPJTRANSPREDESPACHO | Texto | Não | 20 | 99.999.999/9999-99 | Transportadora Redespacho - CNPJ |
NOMETRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Razão Social | |
ENDERECOTRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Endereço | |
NUMEROENDTRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Número do Endereço | |
BAIRROTRANSPREDESPACHO | Texto | Não | 50 | Transportadora Redespacho - Bairro | |
CIDADETRANSPREDESPACHO | Texto | Não | 40 | Transportadora Redespacho - Cidade | |
UFTRANSPREDESPACHO | Texto | Não | 2 | UF Transportadora Redespacho - Estado | |
CEPTRANSPREDESPACHO | Texto | Não | 8 | 99999999 | Transportadora Redespacho - CEP |
INSCESTADUALTRANSPREDESPACHO | Texto | Não | 20 | Transportadora Redespacho - Inscrição Estadual | |
ENDERECOCONSIG | Texto | Não | 80 | Consignatária - Endereco | |
CIDADECONSIG | Texto | Não | 40 | Consignatária - Cidade | |
BAIRROCONSIG | Texto | Não | 50 | Consignatária - Bairro | |
UFCONSIG | Texto | Não | 2 | UF | Consignatária - Estado |
CEPCONSIG | Texto | Não | 8 | 14400000 | Consignatária - CEP |
INSCRICAOESTCONSIG | Texto | Não | 20 | Consignatária - Inscricao Estadual | |
PESSOACONSIG | Texto | Não | 1 | J | Entidade Consignatária - Fisica = F / Juridica = J |
CODIGOCONSIG | Texto | Não | 20 | Entidade Consignatária - Codigo | |
RAZAOSOCIALCONSIG | Texto | Não | 60 | Razão social consignatária | |
FANTASIACONSIG | Texto | Não | 60 | Entidade Consignatária - Nome Fantasia | |
NUMEROENDCONSIG | Texto | Não | 10 | Entidade Consignatária - Endereco Numero | |
COMPLEMENTOENDCONSIG | Texto | Não | 50 | Entidade Consignatária - Complemento | |
INSCRICAOESTEMITENTE | Texto | Não | 21 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
CODIGOSERVICOTRANSPORTADORA | Texto | Não | 60 | Indica o código de serviço a ser utilizado pela transportadora | |
PICKTOLIGHT | Texto | Não | 1 | 0 | Indica se a nota fiscal utilizara o processo de separac?o via pick to light (PTL) - 1= Sim / 0 = Nao |
ROTEIRO | Texto | Não | 255 | Indica o número do roteiro de entrega da nota fiscal | |
CODIGOTIPOPEDIDO | Texto | Não | 100 | Indica código integração do tipo de pedido | |
EMBARQUEPRIORITARIO | Texto | Não | 1 | Indica se a Nota Fiscal tem embarque prioritário (fast track) 0-Não 1-Sim | |
TIPOREGIMETRIBUTACAO | Texto | Não | 1 | Regime de Tributacao - Default 0 | |
SEQENTREGA | Numérico | Não | 12 | Obrigatório será Sim -Se Roteiro Informado | |
RAZAOSOCIALEMITENTE | Texto | Não | 60 | Razão social Emitente | |
FANTASIAEMITENTE | Texto | Não | 60 | Nome Fantasia do emitente da nota fiscal | |
CODIGORETENCAO | Texto | Não | 50 | Código interno do motivo (utilizado pelo ERP) | |
VALORICMSDESONERADO | Numérico | Não | 12 | 000000000,00 | Valor de Icms Desonerado |
PRESENCACOMPRADOR | Texto | Não | 12 | 0 - Não se aplica (por exemplo, Nota Fiscal complementar ou de ajuste) - (0); 1 - Operação presencial - (1); 2 - Operação não presencial, pela Internet - (2); 3 - Operação não presencial, Teleatendimento - (3); 4 - NFC-e em operação com entrega a domicílio - (4); 5 - Operação presencial, fora do estabelecimento - (5); 6 - Operação não presencial, outros. - (9) | |
FORMAPAGAMENTO | Texto | Não | 12 | Forma de pagamento: | |
TIPOENTRADA | Texto | Não | 1 | Tipo de Entrada do Documento: 0 - Nota Fiscal; 1 - Transferência | |
BARRASEPARACAO | Texto | Não | 20 | Identifica o pedido ou nota fiscal com valor único | |
SEMANARECEBIMENTO | Texto | Não | 3 | Semana de recebimento | |
ANORECEBIMENTO | Texto | Não | 4 | 2022 | Ano de recebimento |
SEMANADISPONIBILIZACAO | Texto | Não | 3 | Semana de Disponibilizacao | |
ANODISPONIBILIZACAO | Texto | Não | 4 | 2022 | Ano de Disponibilizacao |
UTILIZAZPL | Texto | Não | 1 | Indica se a nota fiscal utiliza etiqueta externa do tipo ZPL. 0 - Não, 1 - Sim. | |
CODIGORASTREIO | Texto | Não | 25 | Código de rastreio do volume onde os itens da nota se encontram | |
AGRUPADORPED | Numérico | Não | 12 | 999999999999 | Quantidade de remessas existentes para o pedido (agrupador) no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) |
IDORDEMTRANSSAIDA | Numérico | Não | |||
CODIGOPAISDESTINATARIO | Texto | Não | 4 | Código do país para destinatário/entrega estrangeira | |
CODIGOSERVICOETIQUETAEXTERNA | Texto | Não | 100 | Código de integração com serviço de etiqueta externa. Quando utiliza ZPL | |
OBSERVACAOSEPARACAO | Texto | Não | 500 | Observacao deixada pelo cliente em seu pedido. Ex: Solicito colocar o nome abaixo do numero | |
INSCRICAOESTADUALDEPOSITANTE | Texto | Não | 30 | Inscrição estadual do depositante | |
IDINTEGRACAOERP | Texto | Não | 50 | Identificador único no processo de integraçao com o ERP Senior | |
DATAPAGTO | Data | Não | 19 | DD/MM/AAAA hh24:MI:SS | Indica a data de pagamento do pedido / nota fiscal (meramente informativo) |
NUMEROORDEMPRODUCAO | Texto | Não | 20 | Indica o número da Ordem de Produção enviada pelo ERP Senior, utilizado para o fluxo de Consumo Interno para Industrialização. | |
IDMOVIMENTO | Numérico | Não | 12 | 999999999999 | Se a nota fiscal for de saída, representa a Onda, se for de entrada, representa a OR. |
IDNOTAFISCAL | Numérico | Não | 12 | 999999999999 | Identificador do Documento enviado pelo ERP |
CNPJCONSIG | Texto | Não | 20 | 99.999.999/9999-99 | Consignatária - CNPJ |
INTCUBOMETRO | Texto | Não | 1 | Indica se o pedido deve realizar integração com cubômetro. Não = N / Sim = S | |
DATAPLANEJAMENTO | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data Planejada para início da separação do pedido |
FATURAMENTODOISMOMENTOS | Numérico | Não | 1 | Enviar Faturamento em dois momentos. 0 - Não, 1 - Sim | |
DATAFATURAMENTO | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Indica a data de faturamento do pedido / nota fiscal (meramente informativo) |
CANALVENDA | Texto | Não | 20 | Indica o canal de venda do pedido (meramente informativo) | |
JANELAINICIO | Hora | Não | 8 | HH:MM:SS | Hora ínicio da Janela de Atendimento. Utilizado pelo RMS Senior. |
JANELAFIM | Hora | Não | 8 | HH:MM:SS | Hora fim da Janela de Atendimento. Utilizado pelo RMS Senior. |
CODIGOTIPORECEBIMENTO | Texto | Não | 100 | Identificador do tipo de recebimento do pedido | |
PROTOCOLONFE | Texto | Não | 20 | Protocolo da Nota Fiscal Eletrônica | |
DATARECEBIMENTONFE | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data de recebimento do Protocolo da NFE |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
I | Numérico | Sim | 1 | 4 | Valor Fixo |
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Não | 20 | Se for NOTA FISCAL campo NUMÉRICO, se for PEDIDO campo ALFANUMÉRICO | Número do Pedido Preenchimento obrigatório se caso o "NumPedido" tenha sido informado no pedido principal, com isso o item deve ser enviado informando o mesmo número de pedido |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal Sua informação não é obrigatória, porém deve ser igual ao que foi informado no pedido principal | |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S Deve ser informado o mesmo tipo que está sendo enviado no pedido principal | |
IDSEQ | Texto | Sim | 12 | 999999999999 | Sequência do Item (Ordem de impressão dos itens) |
CODIGOINDUSTRIA | Texto | Não | 20 | Preenchimento obrigatório se o campo DESCRPROD estiver vazio. Código Interno do Produto - Depositante | |
DESCRICAOPRODUTO | Texto | Não | 80 | Descrição do Produto | |
BARRAPRODUTO | Texto | Sim | 20 | Código de Barras do Produto | |
CLASSIFICACAOFISCAL | Texto | Não | 5 | Classificação Fiscal do Produto | |
ST | Texto | Não | 2 | Situação Tributária | |
QUANTIDADE | Numérico | Sim | 12 | 999999999999 | Quantidade |
VALORUNITARIO | Numérico | Sim | 12 | 999999999,99 | Valor Unitário |
VALORTOTAL | Numérico | Sim | 12 | 999999999,99 | Valor Total do Item |
ALIQUOTAICMS | Numérico | Não | 6 | 999,99 | Alíquota ICMS |
ALIQUOTAIPI | Numérico | Não | 6 | 999,99 | Alíquota IPI |
IPI | Numérico | Não | 12 | 999999999,99 | IPI |
VALORDESCONTO | Numérico | Não | 12 | 999999999,99 | Valor do Desconto por Item |
PORCENTUALDESCONTO | Numérico | Não | 6 | 999,99 | Desconto - % |
DESCONTO | Numérico | Não | 12 | 999999999,99 | Valor Total do Desconto |
TOTALLIQUIDO | Numérico | Sim | 12 | 999999999,99 | Valor Total Líquido |
TIPOPRODUTO | Texto | Sim | 1 | Produto = P / Serviço = S | |
QUANTIDADEATENDIDA | Numérico | Sim | 12 | 999999999999 | Quantidade Atendida para este Item Caso haja corte o valor retornado será ZERO |
IDNOTAFISCAL | Numérico | Sim | 12 | 999999999999 | Identificador da Notafiscal - Corporativo g-com |
NUMEROSERIE | Texto | Não | 20 | Para saída de um produto com número de série especifico, deve ser informado o número. | |
TIPOMATERIAL | Numérico | Não | 12 | 999999999999 | Identifica o tipo do produto : Lote, patrimônio, etc |
ST3 | Texto | Não | 10 | Situação Tributária com 3 dígitos | |
INSCRICAOESTEMITENTE | Texto | Não | 21 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
DATAVENCIMENTOLOTE | Data | Não | 10 | DD/MM/AAAA | Data vencimento do lote |
DESCRICAOREDUZIDA | Texto | Não | 6 | Será obrigatório apenas se o depositante estiver configurado para importar o produto validando a descrição reduzida Sigla resumida da embalagem. Ex: CX, UN, DP | |
IDITEMERP | Texto | Não | 500 | Identificador do Item do Documento enviado pelo ERP | |
VALORICMSDESONERADO | Numérico | Não | 12 | 000000000,00 | Valor ICMS desonerado |
CODIGOPRODUTOANVISA | Texto | Não | 13 | Código ANVISA do produto | |
PRECOMAXIMOCONSUMIDOR | Numérico | Não | 13 | 9999999999,99 | Preço Máximo Consumidor |
BASEICMS | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS |
VALORICMS | Numérico | Não | 12 | 000000000,00 | Valor ICMS |
IMPORTACAOCOBFISCAL | Texto | Não | 1 | Indica se a importação foi realizada por cobertura fiscal. Sim(S) / Não(N) | |
ALIQUOTAPIS | Numérico | Não | 6 | 999,99 | Alíquota PIS |
BASEPIS | Numérico | Não | 12 | Base PIS | |
VALORPIS | Numérico | Não | 12 | PIS | |
ALIQUOTACOFINS | Numérico | Não | 6 | 999,99 | Alíquota COFINS |
BASECOFINS | Numérico | Não | 12 | Base COFINS | |
VALORCOFINS | Numérico | Não | 12 | COFINS | |
ORIGEMPRODUTO | Texto | Não | Origem do produto | ||
REMESSA | Texto | Não | 20 | Número de remessa a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
NOTAFISCAL | Texto | Não | 20 | Número de nota fiscal a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
SERIENF | Texto | Não | 20 | Número de série da nota fiscal a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
TIPOPTL | Texto | Não | 10 | Indica qual é a linha de PTL onde o item deve ser separado quando o pedido ou nota for marcado como PTL. Representa o código de PTL da Região de Armazenagem | |
TIPOCAIXASEP | Texto | Não | 20 | Indica ao sistema de PTL qual é o tipo de caixa de separação que deve ser utilizado para a geração do volume pelo mesmo | |
VOLUMECAIXA | Numérico | Não | 12 | Indica ao sistema de PTL qual é o número de volume que deve ser utilizado para a sua geração, indicando que os materiais devem ser isolados em determinado volume | |
MENSAGEMCAIXA | Texto | Não | 30 | Indica ao sistema de PTL qual é a mensagem que deve ser impressa ao destinatário para casos de mensagem de presente por exemplo | |
CODSETOR | Texto | Não | 100 | Código de Depósito informado pelo ERP | |
MOTIVOISENCAO | Texto | Não | 255 | Motivo da isenção da ANVISA. Para medicamento isento de registro na ANVISA deve informar o número da decisão que o isenta | |
NUMEROORDEMCOMPRA | Texto | Não | 40 | Número Ordem de Compra | |
OBSITEMSEPARACAO | Texto | Não | 999 | Observação deixada pelo cliente em seu pedido especifico para cada item. Ex: Nome: Cliente, Numero: 10 |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CHAVE | Texto | Sim | 20 | Campo de personalização | |
CODIGOINTERNO | Texto | Sim | 20 | Valor do campo de personalização |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
NUMERONF | Texto | Sim | 60 | Número da Nota Fiscal. Deve ser igual ao campo “codigoInterno” informado no pedido principal | |
SERIENF | Texto | Não | 20 | Série da Nota Fiscal. Apesar de não obrigatório deve ser enviado o que foi informado no campo “sequência” no pedido principal | |
LOTE | Texto | Não | 10 | Lote Indústria utilizado na conferência | |
DATAVALIDADE | Texto | Não | 20 | Data de Validade do Lote | |
DATAFABRICACAO | Texto | Não | 20 | Data de Fabricação do Lote | |
CODIGOPRODUTO | Texto | Não | 13 | Código Interno do Produto | |
QUANTIDADE | Numérico | Sim | 12 | 999999999999 | Quantidade conferencia do lote |
IDSEQ | Numérico | Sim | 12 | IDSEQUENCIA de envio do produto | |
IDSEQCFE | Numérico | Não | 12 | IDSEQUENCIA de envio da conferência específica |
Response
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
tipointegração: EXP_OR_MODELO_MOV_REST
O WMS Senior realiza a comunicação do Retorno de Recebimento para o ERP, permitindo que o mesmo confirme o recebimento do material. Ou seja, após a alocação do material, é enviada a interface de Movimentação de Estoque. Vale observar que esta é a mesma interface utilizada para "Ajuste de Movimentação", "Bloqueio e Desbloqueio de Lote", "Controle de Avaria", "Remanejamento" e "Retorno de Produto Recuperado".
Request
{ "chavelayout" : "vi_int_envio_mudanca_estoque", "list" : [ { "datahora" : "", "cnpjarmazem" : "", "cnpjdepositante" : "", "estoqueorigem" : "", "estadoorigem" : "", "tipomovto" : "", "estoquedestino" : "", "estadodestino" : "", "codmotivo" : "", "codproduto" : "", "produto" : "", "barra" : "", "descricaoreduzida" : "", "fatorconversao" : "", "qtde" : "", "idmovimento_wms" : "", "loteindustria" : "", "vencimento" : "", "cnpjemitente" : "", "notafiscal" : "", "serie" : "", "motivo" : "", "datamovimentacao" : "", "codtransp" : "", "classificacaoveiculo" : "", "placaveiculo" : "", "motoristaveiculo" : "", "qtdevolume" : "", "pesokg" : "", "tiporecebimento" : "", "infocomplementar" : "", "pedido" : "", "inventario" : "", "informacaoespecifica" : "", "valorinfoespecifica" : "", "codsetororigem" : "", "codsetordestino" : "", "idseqitem" : "", "codreferencia" : "", "idintegracaoerp" : "", "chaveacessonfe" : "", "qtdesetororigem": "", "qtdesetordestino": "", "idIntegracaoReferenciado": "" } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
DATAHORA | Data | Não | 15 | DDMMYYYY-HH24MISS | Data e hora de integração. Formato DDMMYYYY-HH24MISS |
CNPJARMAZEM | Texto | Não | 20 | 99.999.999/9999-99 | Indica o armazém do estoque origem |
CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | Identifica o depositante |
ESTOQUEORIGEM | Texto | Não | 40 | Código de integração do estoque de origem | |
ESTADOORIGEM | Texto | Não | 1 | Estado do produto. N-Normal; D- Danificado; T- Truncado/Vencido | |
TIPOMOVTO | Numérico | Não | 1 | Indica o tipo da movimentação. 1 = Exportar OR com lote indústria; 2 = Ajuste de Movimentação Entrada; 3 = Ajuste de Movimentação Saída; 4 = Bloqueio de Lote; 5 = Desbloqueio de Lote; 6 = Controle de Avaria; 7 = Produto Recuperado; 8 = Mudança entre códigos de setores; 9 - Exportação OR Após Geração do Mapa Alocação; 10 - Exportar OR Devolução com lote indústria | |
ESTOQUEDESTINO | Texto | Não | 40 | Código de integração do estoque destino | |
ESTADODESTINO | Texto | Não | 1 | Estado do produto. N- Normal; D - Danificado; T - Truncado/Vencido. | |
CODMOTIVO | Texto | Não | 20 | Código do motivo de ocorrência | |
CODPRODUTO | Texto | Não | 60 | Identifica o produto | |
PRODUTO | Texto | Não | 120 | Descrição do produto | |
BARRA | Texto | Não | 32 | Código de barra da embalagem do produto | |
DESCRICAOREDUZIDA | Texto | Não | 6 | Descrição reduzida da embalagem (UN, CX, FD, GALÃO, etc) | |
FATORCONVERSAO | Numérico | Não | 12 | Fator a ser utilizado para conversão da quantidade do ajuste para unidade. Este campo possui o limite de 6 caracteres | |
QTDE | Numérico | Não | 12 | Quantidade para mudança de estado do código de barras informando | |
IDMOVIMENTO_WMS | Numérico | Não | 12 | Indica o id do controle de MUDANÇA DE ESTADO (Avaria, Produto Recuperado e/ou mudança de estado) | |
LOTEINDUSTRIA | Texto | Não | 60 | Indica o lote que sofreu a mudança de estado | |
VENCIMENTO | Data | Não | 8 | DD/MM/AAAA | Indica a data de vencimento que sofreu a mudança de estado |
CNPJEMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Indica o CNPJ do emitente da nota fiscal para operações de bloqueio/desbloqueio de lotes (resposta) |
NOTAFISCAL | Texto | Não | 20 | Número da nota fiscal de recebimento para bloqueio/desbloqueio de lotes | |
SERIE | Texto | Não | 20 | Número da série da nota fiscal de recebimento para bloqueio/desbloqueio de lotes | |
MOTIVO | Texto | Não | 100 | Motivo pelo qual o ajuste foi realizado | |
DATAMOVIMENTACAO | Data | Não | 15 | Data de cadastro da ordem de recebimento | |
CODTRANSP | Texto | Não | 6 | Código transportadora | |
CLASSIFICACAOVEICULO | Texto | Não | 10 | Classificação veículo | |
PLACAVEICULO | Texto | Não | 8 | Placa | |
MOTORISTAVEICULO | Texto | Não | 30 | Motorista | |
QTDEVOLUME | Numérico | Não | 2 | Qtde volume | |
PESOKG | Numérico | Não | 9 | Peso (KG) | |
TIPORECEBIMENTO | Texto | Não | 1 | Tipo de recebimento | |
INFOCOMPLEMENTAR | Texto | Não | 255 | Informações Complementares | |
PEDIDO | Texto | Não | 20 | Número do pedido | |
INVENTARIO | Numérico | Não | 12 | Indica o inventário que gerou o ajuste de movimentação | |
INFORMACAOESPECIFICA | Texto | Não | 50 | Informação específica | |
VALORINFOESPECIFICA | Texto | Não | 50 | Valor informação específica | |
CODSETORORIGEM | Texto | Não | 100 | Identifica o código de integração definido no vínculo entre setor/depositante referente ao depósito de origem da mudança de estoque | |
CODSETORDESTINO | Texto | Não | 100 | Identifica o código de integração definido no vínculo entre setor/depositante referente ao depósito de origem da mudança de estoque | |
IDSEQITEM | Numérico | Não | 12 | IDSEQ(sequência) do item da nota fiscal de entrada | |
CODREFERENCIA | Texto | Não | 60 | Código de referência do produto | |
IDINTEGRACAOERP | Numérico | Não | 50 | Identificador único no processo de integração com o ERP Senior | |
CHAVEACESSONFE | Texto | Não | 44 | Chave de Acesso da NF-e | |
QTDESETORORIGEM | Texto | Não | 12 | Quantidade para o setor origem | |
QTDESETORDESTINO | Texto | Não | 12 | Quantidade para o setor destino | |
IDINTEGRACAOREFERENCIADO | Texto | Não | 50 | Na integração de "Bloqueio e Desbloqueio de Lote", este campo permitirá que o ERP Senior identifique qual OR deu origem ao Lote Bloqueado |
Expedição
Endpoint para a integração de Pedidos, Notas Fiscais ou Requisição de Separação, responsáveis pela integração do material a ser separados no fluxo de Expedição no WMS Senior. A comunicação neste endpoint é assíncrona, ou seja, no Response (da requisição de cadastro) é informado um número de protocolo que pode ser utilizado posteriormente para consultar o status (erro, sucesso, agendado) no Log de Integração.
Request
{ "numPedido": "", "sequencia": "", "cnpjDepositante": "", "codigoInterno": "", "cnpjEmitente": "", "tipo": "", "descrOper": "", "cfop": "", "dataEmissao": "", "pessoaDestinatario": "", "codigoDestinatario": "", "nomeDestinatario": "", "fantasiaDestinatario": "", "cnpjDestinatario": "", "enderecoDestinatario": "", "numeroEndDestinatario": "", "complementoEndDestinatario": "", "bairroDestinatario": "", "cepDestinatario": "", "cidadeDestinatario": "", "telefoneDestinatario": "", "telefone2": "", "ufDestinatario": "", "inscricaoEstadualDestinatario": "", "inscricaoMunicipalDestinatario": "", "enderecoEntrega": "", "cidadeEntrega": "", "bairroEntrega": "", "ufEntrega": "", "cepEntrega": "", "cnpjEntrega": "", "inscricaoEstadualEntrega": "", "baseIcms": 0, "valorIcms": 0, "baseSubstituicao": 0, "valorSubstituicao": 0, "frete": 0, "seguro": 0, "despesasAcessorias": 0, "ipi": 0, "valorProdutos": 0, "valorTotal": 0, "nomeTransportadora": "", "cnpjTransportadora": "", "enderecoTransportadora": "", "numeroEndTransportadora": "", "bairroTransportadora": "", "cidadeTransportadora": "", "ufTransportadora": "", "cepTransportadora": "", "inscricaoEstadualTransportadora": "", "cifFob": "", "veiculo": "", "ufVeiculo": "", "qtde": 0, "especie": "", "marca": "", "numero": "", "pesoLiquido": 0, "pis": 0, "cofins": 0, "cs": 0, "ir": 0, "valorIss": 0, "valorServicos": 0, "geraFinanceiro": "", "tipoDocumento": "", "tipoCarga": "", "limiteCorte": 0, "paginaGeomapa": "", "numItens": 0, "tipoNf": "", "estado": "", "dataColeta": "", "dataAgendamento": "", "horaColeta": "", "pessoaEntrega": "", "codigoEntrega": "", "nomeEntrega": "", "fantasiaEntrega": "", "numeroEndEntrega": "", "complementoEndEntrega": "", "nomeRepresentante": "", "telefoneRepresentante": "", "cnpjUnidade": "", "fatura": "", "observacao": "", "estoqueVerificado": "", "chaveIdentificacaoExt": "", "classificacaoCliente": 0, "prioridade": "", "porcentagemCxFechada": 0, "chaveAcessoNFE": "", "cnpjTranspRedespacho": "", "nomeTranspRedespacho": "", "enderecoTranspRedespacho": "", "numeroEndTranspRedespacho": "", "bairroTranspRedespacho": "", "cidadeTranspRedespacho": "", "ufTranspRedespacho": "", "cepTranspRedespacho": "", "inscEstadualTranspRedespacho": "", "enderecoConsig": "", "cidadeConsig": "", "bairroConsig": "", "ufConsig": "", "cepConsig": "", "inscricaoEstConsig": "", "pessoaConsig": "", "codigoConsig": "", "razaoSocialConsig": "", "fantasiaConsig": "", "numeroEndConsig": "", "complementoEndConsig": "", "inscricaoEstEmitente": "", "codigoServicoTransportadora": "", "pickToLight": "", "roteiro": "", "codigoTipoPedido": "", "embarquePrioritario": "", "tipoRegimeTributacao": "", "seqEntrega": 0, "razaoSocialEmitente": "", "fantasiaEmitente": "", "codigoRetencao": "", "valorIcmsDesonerado": 0, "presencaComprador": "", "formaPagamento": "", "tipoEntrada": "", "barraSeparacao": "", "semanaRecebimento": "", "anoRecebimento": "", "semanaDisponibilizacao": "", "anoDisponibilizacao": "", "utilizaZPL": "", "codigoRastreio": "", "agrupadorPed": 0, "idOrdemTransSaida": 0, "codigoPaisDestinatario": "", "codigoServicoEtiquetaExterna": "", "observacaoSeparacao": "", "inscricaoEstadualDepositante": "", "idIntegracaoErp": "", "dataPagto": "", "numeroOrdemProducao": "", "idMovimento": "", "idNotaFiscal": 0, "cnpjConsig": "", "intCubometro": "", "dataPlanejamento": "", "faturamentoDoisMomentos": "", "dataFaturamento": "", "canalVenda": "", "janelaInicio": "", "janelaFim": "", "codigoTipoRecebimento": "", "protocoloNfe": "", "dataRecebimentoNfe": "", "personalizacaoItem": [ , { "chave": "", "valor": "", } ], "itens": [ { "codigoInterno": "", "numPedido": "", "cnpjDepositante": "", "cnpjEmitente": "", "sequencia": "", "tipo": "", "idSeq": "", "codigoIndustria": "", "descricaoProduto": "", "barraProduto": "", "classificacaoFiscal": "", "st": "", "quantidade": "", "valorUnitario": "", "valorTotal": "", "aliquotaICMS": "", "aliquotaIPI": "", "ipi": "", "valorDesconto": "", "porcentualDesconto": "", "desconto": "", "totalLiquido": "", "tipoProduto": "", "quantidadeAtendida": "", "idNotaFiscal": "", "numeroSerie": "", "tipoMaterial": "", "st3": "", "inscricaoEstEmitente": "", "dataVencimentoLote": "", "descricaoReduzida": "", "idItemERP": "", "valorICMSdesonerado": "", "codigoProdutoAnvisa": "", "precoMaximoConsumidor": "", "baseICMS": "", "valorICMS": "", "importacaoCobFiscal": "", "aliquotaPIS": "", "basePIS": "", "valorPIS": "", "aliquotaConfins": "", "baseConfins": "", "valorConfins": "", "origemProduto": "", "remessa": "", "notaFiscal": "", "serieNF": "", "tipoPTL": "", "tipoCaixaSep": "", "volumeCaixa": "", "mensagemCaixa": "", "codigoSetor": "", "motivoIsencao": "", "numeroOrdemCompra": "", "obsItemSeparacao": "", "itensConferenciaEspecifica": { "numeroNf": "", "serieNf": "", "lote": "", "dataValidade": "", "dataFabricacao": "", "codigoProduto": "", "quantidade": 0, "idSeq": 0, "idSeqCfe": 0 } } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
NUMPEDIDO | Texto | Não | 20 | Se for NOTA FISCAL campo NUMÉRICO, se for PEDIDO campo Alfanumérico | Número do Pedido |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S | |
DESCROPER | Texto | Sim | 100 | Descrição da Operação | |
CFOP | Texto | Não | 4 | CFOP(Código Fiscal de Operação) NÃO é obrigatório caso o CFOP padrão de importação esteja definido (caso contrário sua informação se torna obrigatório no envio da requisição). | |
DATAEMISSAO | Data | Sim | 10 | DD/MM/AAAA | Data da Nota Fiscal |
PESSOADESTINATARIO | Texto | Sim | 1 | Destinatário - Física = F / Jurídica = J | |
CODIGODESTINATARIO | Texto | Sim | 20 | Código do Destinatário | |
NOMEDESTINATARIO | Texto | Sim | 60 | Destinatário - Razão Social | |
FANTASIADESTINATARIO | Texto | Não | 60 | Destinatário - Nome Fantasia | |
CNPJDESTINATARIO | Texto | Sim | 20 | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Destinatário - CNPJ para PJ / CPF para PF |
ENDERECODESTINATARIO | Texto | Sim | 80 | Destinatário - Endereço | |
NUMEROENDDESTINATARIO | Texto | Não | 10 | Destinatário - Endereço Número | |
COMPLEMENTOENDDESTINATARIO | Texto | Não | 50 | Destinatário - Complemento, Caso esse campo possua mais que 50 caracteres deixa-lo vazio e usar o campo COMPLEMENTO_DEST | |
BAIRRODESTINATARIO | Texto | Sim | 50 | Destinatário - Bairro | |
CEPDESTINATARIO | Texto | Sim | 8 | 99999999 | Destinatário - CEP |
CIDADEDESTINATARIO | Texto | Sim | 40 | Destinatário - Cidade | |
TELEFONEDESTINATARIO | Texto | Sim | 20 | Destinatário - Telefone | |
TELEFONE2 | Texto | Não | 20 | Destinatário - Telefone adicional | |
UFDESTINATARIO | Texto | Sim | 2 | Destinatário - Estado | |
INSCRICAOESTADUALDESTINATARIO | Texto | Não | 20 | Destinatário - Inscrição Estadual | |
INSCRICAOMUNICIPALDESTINATARIO | Texto | Não | 20 | Destinatário - Inscrição Municipal | |
ENDERECOENTREGA | Texto | Não | 80 | Será obrigatório se houverem dados de entrega Entrega - Endereço | |
CIDADEENTREGA | Texto | Não | 40 | Será obrigatório se houverem dados de entrega Entrega - Cidade | |
BAIRROENTREGA | Texto | Não | 50 | Será obrigatório se houverem dados de entrega Entrega - Bairro | |
UFENTREGA | Texto | Não | 2 | Será obrigatório se houverem dados de entrega Entrega - Estado | |
CEPENTREGA | Texto | Não | 8 | 99999999 | Será obrigatório se houverem dados de entrega Entrega - CEP |
CNPJENTREGA | Texto | Não | 20 | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Será obrigatório se houverem dados de entrega Entrega - CNPJ ou CPF |
INSCRICAOESTADUALENTREGA | Texto | Não | 20 | Entrega - Inscrição Estadual | |
BASEICMS | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS |
VALORICMS | Numérico | Não | 12 | 000000000,00 | Valor ICMS |
BASESUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS Substituição |
VALORSUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Valor do ICMS Substituição |
FRETE | Numérico | Não | 12 | 000000000,00 | Valor do Frete |
SEGURO | Numérico | Não | 12 | 000000000,00 | Valor do Seguro |
DESPESASACESSORIAS | Numérico | Não | 12 | 000000000,00 | Outras Despesas Acessórias |
IPI | Numérico | Não | 12 | 000000000,00 | Valor Total do IPI |
VALORPRODUTOS | Numérico | Sim | 12 | 000000000,00 | Valor Total dos Produtos |
VALORTOTAL | Numérico | Sim | Não | 000000000,00 | Valor Total da Nota |
NOMETRANSPORTADORA | Texto | Sim | 60 | Transportadora - Razão Social | |
CNPJTRANSPORTADORA | Texto | Sim | 20 | 99.999.999/9999-99 | Transportadora - CNPJ |
ENDERECOTRANSPORTADORA | Texto | Sim | 80 | Transportadora - Endereço | |
NUMEROENDTRANSPORTADORA | Texto | Sim | 10 | Transportadora - Endereço Número | |
BAIRROTRANSPORTADORA | Texto | Sim | 50 | Transportadora - Bairro | |
CIDADETRANSPORTADORA | Texto | Sim | 40 | Transportadora - Cidade | |
UFTRANSPORTADORA | Texto | Sim | 2 | Transportadora - Estado | |
CEPTRANSPORTADORA | Texto | Sim | 8 | 99999999 | Transportadora - CEP |
INSCRICAOESTADUALTRANSPORTADORA | Texto | Sim | 20 | Transportadora - Inscrição Estadual | |
CIFFOB | Texto | Sim | 1 | Transportadora - Modalidade do Frete Por Conta: (1) Contratação do Frete por conta do Remetente (CIF), (2) Contratação do Frete por conta do Destinatário (FOB), (4) Contratação do Frete por conta de Terceiros, (5)Sem Ocorrência de Transporte, (6)Transporte Próprio por conta do Remetente e (7)Transporte Próprio por conta do Destinatário | |
VEICULO | Texto | Não | 20 | Transportadora - Placa do Veículo | |
UFVEICULO | Texto | Não | 2 | Transportadora - Estado | |
QTDE | Numérico | Não | 12 | 999999999999 | Transportadora - Quantidade |
ESPECIE | Texto | Não | 20 | Transportadora - Espécie | |
MARCA | Texto | Não | 20 | Transportadora - Marca | |
NUMERO | Texto | Não | 20 | Transportadora - Número | |
PESOLIQUIDO | Numérico | Sim | 12 | 999999999999 | Transportadora - Peso Líquido (gramas) |
PIS | Numérico | Não | 12 | 000000000,00 | PIS |
COFINS | Numérico | Não | 12 | 000000000,00 | COFINS |
CS | Numérico | Não | 12 | 000000000,00 | Contribuição Social |
IR | Numérico | Não | 12 | 000000000,00 | Imposto de Renda |
VALORISS | Numérico | Não | 12 | 000000000,00 | Valor do ISS |
VALORSERVICOS | Numérico | Não | 12 | 000000000,00 | Valor do Serviço |
GERAFINCEIRO | Texto | Não | 1 | Sim / Nao | Vai para o Acerto de Carga ou Não |
TIPODOCUMENTO | Texto | Não | 5 | Tipo Documento | Tipo do Documento Cobrança - Dinheiro = D / Cheque = C / Boleto = B / X = Bonificação / Outros = T |
TIPOCARGA | Texto | Não | 10 | Tipo da Carga - Produtos Refrigerados, Secos, Especiais | |
LIMITECORTE | Numérico | Não | 12 | 000000000,00 | Valor Mínimo para cancelar o pedido. |
PAGINAGEOMAPA | Texto | Não | 12 | 999999999999 | Página Geo Mapa ou Setor |
NUMITENS | Numérico | Sim | 12 | 000000000,00 | Quantidade de produtos distintos existentes no pedido/nota |
TIPONF | Texto | Sim | 1 | Pedido/Notafiscal | Indica se o Registro é um Pedido (P) ou uma Nota Fiscal (N) |
ESTADO | Texto | Não | 1 | Indica o estado do Pedido/NotaFiscal (N) Bom, (D) Danificado, (T) Truncado ou Vencido. | |
DATACOLETA | Data | Não | 10 | DD/MM/AAAA | Data prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. |
DATAAGENDAMENTO | Data | Não | 19 | DD/MM/AAAA HH:MM:SS | Indica a data agendada pelo destinatário para entrega do pedido/nota fiscal (Utilizado pelo RMS Senior) |
HORACOLETA | Hora | Não | 8 | HH24:MM:SS | Hora prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. |
PESSOAENTREGA | Texto | Não | 1 | F / J | Entidade de Entrega - Física = F / Jurídica = J |
CODIGOENTREGA | Texto | Não | 20 | Código da Entidade de Entrega | |
NOMEENTREGA | Texto | Não | 60 | Entidade de Entrega - Razão Social | |
FANTASIAENTREGA | Texto | Não | 60 | Entidade de Entrega - Nome Fantasia | |
NUMENDENTREGA | Texto | Não | 10 | Entidade de Entrega - Endereço Número | |
COMPLEMENTOENDENTREGA | Texto | Não | 50 | Entidade de Entrega - Complemento | |
NOMEREPRESENTANTE | Texto | Não | 60 | Nome do representante de vendas | |
TELEFONEREPRESENTANTE | Texto | Não | 20 | Telefone do representante de vendas | |
CNPJUNIDADE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Da Unidade de Armazenagem |
FATURA | Texto | Não | 50 | Texto livre | Condições de Pagamento |
OBSERVACAO | Texto | Não | 200 | Texto livre | Dados adicionais |
ESTOQUEVERIFICADO | Texto | Não | 1 | S / N / B | Indica se a nota fiscal vai verificar estoque ou não. "N" = Não Liberado / "B" = Bloqueado / "S" = Liberado |
CHAVEIDENTIFICACAOEXT | Texto | Não | 20 | Texto livre | Chave de identificação externa do documento |
CLASSIFICACAOCLIENTE | Numérico | Não | 12 | 999999999999 | Indica a classificação do Cliente para prioridade de liberação |
PRIORIDADE | Texto | Não | 1 | Indica a prioridade do valor do pedido. P, M, G | |
PORCENTAGEMCXFECHADA | Numérico | Não | 12 | 000000000,00 | Indica a porcentagem de caixa fechada para prioridade de liberação |
CHAVEACESSONFE | Texto | Não | 44 | Indica a chave de acesso da NFe. | |
CNPJTRANSPREDESPACHO | Texto | Não | 20 | 99.999.999/9999-99 | Transportadora Redespacho - CNPJ |
NOMETRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Razão Social | |
ENDERECOTRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Endereço | |
NUMEROENDTRANSPREDESPACHO | Texto | Não | 60 | Transportadora Redespacho - Número do Endereço | |
BAIRROTRANSPREDESPACHO | Texto | Não | 50 | Transportadora Redespacho - Bairro | |
CIDADETRANSPREDESPACHO | Texto | Não | 40 | Transportadora Redespacho - Cidade | |
UFTRANSPREDESPACHO | Texto | Não | 2 | UF Transportadora Redespacho - Estado | |
CEPTRANSPREDESPACHO | Texto | Não | 8 | 99999999 | Transportadora Redespacho - CEP |
INSCESTADUALTRANSPREDESPACHO | Texto | Não | 20 | Transportadora Redespacho - Inscrição Estadual | |
ENDERECOCONSIG | Texto | Não | 80 | Consignatária - Endereco | |
CIDADECONSIG | Texto | Não | 40 | Consignatária - Cidade | |
BAIRROCONSIG | Texto | Não | 50 | Consignatária - Bairro | |
UFCONSIG | Texto | Não | 2 | UF | Consignatária - Estado |
CEPCONSIG | Texto | Não | 8 | 14400000 | Consignatária - CEP |
INSCRICAOESTCONSIG | Texto | Não | 20 | Consignatária - Inscricao Estadual | |
PESSOACONSIG | Texto | Não | 1 | J | Entidade Consignatária - Fisica = F / Juridica = J |
CODIGOCONSIG | Texto | Não | 20 | Entidade Consignatária - Codigo | |
RAZAOSOCIALCONSIG | Texto | Não | 60 | Razão social consignatária | |
FANTASIACONSIG | Texto | Não | 60 | Entidade Consignatária - Nome Fantasia | |
NUMEROENDCONSIG | Texto | Não | 10 | Entidade Consignatária - Endereco Numero | |
COMPLEMENTOENDCONSIG | Texto | Não | 50 | Entidade Consignatária - Complemento | |
INSCRICAOESTEMITENTE | Texto | Não | 21 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
CODIGOSERVICOTRANSPORTADORA | Texto | Não | 60 | Indica o código de serviço a ser utilizado pela transportadora | |
PICKTOLIGHT | Texto | Não | 1 | 0 | Indica se a nota fiscal utilizara o processo de separac?o via pick to light (PTL) - 1= Sim / 0 = Nao |
ROTEIRO | Texto | Não | 255 | Indica o número do roteiro de entrega da nota fiscal | |
CODIGOTIPOPEDIDO | Texto | Não | 100 | Indica código integração do tipo de pedido | |
EMBARQUEPRIORITARIO | Texto | Não | 1 | Indica se a Nota Fiscal tem embarque prioritário (fast track) 0-Não 1-Sim | |
TIPOREGIMETRIBUTACAO | Texto | Não | 1 | Regime de Tributacao - Default 0 | |
SEQENTREGA | Numérico | Não | 12 | Obrigatório será Sim -Se Roteiro Informado | |
RAZAOSOCIALEMITENTE | Texto | Não | 60 | Razão social Emitente | |
FANTASIAEMITENTE | Texto | Não | 60 | Nome Fantasia do emitente da nota fiscal | |
CODIGORETENCAO | Texto | Não | 50 | Código interno do motivo (utilizado pelo ERP) | |
VALORICMSDESONERADO | Numérico | Não | 12 | 000000000,00 | Valor de Icms Desonerado |
PRESENCACOMPRADOR | Texto | Não | 12 | 0 - Não se aplica (por exemplo, Nota Fiscal complementar ou de ajuste) - (0); 1 - Operação presencial - (1); 2 - Operação não presencial, pela Internet - (2); 3 - Operação não presencial, Teleatendimento - (3); 4 - NFC-e em operação com entrega a domicílio - (4); 5 - Operação presencial, fora do estabelecimento - (5); 6 - Operação não presencial, outros. - (9) | |
FORMAPAGAMENTO | Texto | Não | 12 | Forma de pagamento: | |
TIPOENTRADA | Texto | Não | 1 | Tipo de Entrada do Documento: 0 - Nota Fiscal; 1 - Transferência | |
BARRASEPARACAO | Texto | Não | 20 | Identifica o pedido ou nota fiscal com valor único | |
SEMANARECEBIMENTO | Texto | Não | 3 | Semana de recebimento | |
ANORECEBIMENTO | Texto | Não | 4 | 2022 | Ano de recebimento |
SEMANADISPONIBILIZACAO | Texto | Não | 3 | Semana de Disponibilizacao | |
ANODISPONIBILIZACAO | Texto | Não | 4 | 2022 | Ano de Disponibilizacao |
UTILIZAZPL | Texto | Não | 1 | Indica se a nota fiscal utiliza etiqueta externa do tipo ZPL. 0 - Não, 1 - Sim. | |
CODIGORASTREIO | Texto | Não | 25 | Código de rastreio do volume onde os itens da nota se encontram | |
AGRUPADORPED | Numérico | Não | 12 | 999999999999 | Quantidade de remessas existentes para o pedido (agrupador) no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) |
IDORDEMTRANSSAIDA | Numérico | Não | |||
CODIGOPAISDESTINATARIO | Texto | Não | 4 | Código do país para destinatário/entrega estrangeira | |
CODIGOSERVICOETIQUETAEXTERNA | Texto | Não | 100 | Código de integração com serviço de etiqueta externa. Quando utiliza ZPL | |
OBSERVACAOSEPARACAO | Texto | Não | 500 | Observacao deixada pelo cliente em seu pedido. Ex: Solicito colocar o nome abaixo do numero | |
INSCRICAOESTADUALDEPOSITANTE | Texto | Não | 30 | Inscrição estadual do depositante | |
IDINTEGRACAOERP | Texto | Não | 50 | Identificador único no processo de integraçao com o ERP Senior | |
DATAPAGTO | Data | Não | 19 | DD/MM/AAAA hh24:MI:SS | Indica a data de pagamento do pedido / nota fiscal (meramente informativo) |
NUMEROORDEMPRODUCAO | Texto | Não | 20 | Indica o número da Ordem de Produção enviada pelo ERP Senior, utilizado para o fluxo de Consumo Interno para Industrialização. | |
IDMOVIMENTO | Numérico | Não | 12 | 999999999999 | Se a nota fiscal for de saída, representa a Onda, se for de entrada, representa a OR. |
IDNOTAFISCAL | Numérico | Não | 12 | 999999999999 | Identificador do Documento enviado pelo ERP |
CNPJCONSIG | Texto | Não | 20 | 99.999.999/9999-99 | Consignatária - CNPJ |
INTCUBOMETRO | Texto | Não | 1 | Indica se o pedido deve realizar integração com cubômetro. Não = N / Sim = S | |
DATAPLANEJAMENTO | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data Planejada para início da separação do pedido |
FATURAMENTODOISMOMENTOS | Numérico | Não | 1 | Enviar Faturamento em dois momentos. 0 - Não, 1 - Sim | |
DATAFATURAMENTO | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Indica a data de faturamento do pedido / nota fiscal (meramente informativo) |
CANALVENDA | Texto | Não | 20 | Indica o canal de venda do pedido (meramente informativo) | |
JANELAINICIO | Hora | Não | 8 | HH:MM:SS | Hora ínicio da Janela de Atendimento. Utilizado pelo RMS Senior. |
JANELAFIM | Hora | Não | 8 | HH:MM:SS | Hora fim da Janela de Atendimento. Utilizado pelo RMS Senior. |
CODIGOTIPORECEBIMENTO | Texto | Não | 100 | Identificador do tipo de recebimento do pedido | |
PROTOCOLONFE | Texto | Não | 20 | Protocolo da Nota Fiscal Eletrônica | |
DATARECEBIMENTONFE | Data | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data de recebimento do Protocolo da NFE |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
I | Numérico | Sim | 1 | 4 | Valor Fixo |
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Não | 20 | Se for NOTA FISCAL campo NUMÉRICO, se for PEDIDO campo ALFANUMÉRICO | Número do Pedido Preenchimento obrigatório se caso o "NumPedido" tenha sido informado no pedido principal, com isso o item deve ser enviado informando o mesmo número de pedido |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal Sua informação não é obrigatória, porém deve ser igual ao que foi informado no pedido principal | |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S Deve ser informado o mesmo tipo que está sendo enviado no pedido principal | |
IDSEQ | Texto | Sim | 12 | 999999999999 | Sequência do Item (Ordem de impressão dos itens) |
CODIGOINDUSTRIA | Texto | Não | 20 | Preenchimento obrigatório se o campo DESCRPROD estiver vazio. Código Interno do Produto - Depositante | |
DESCRICAOPRODUTO | Texto | Não | 80 | Descrição do Produto | |
BARRAPRODUTO | Texto | Sim | 20 | Código de Barras do Produto | |
CLASSIFICACAOFISCAL | Texto | Não | 5 | Classificação Fiscal do Produto | |
ST | Texto | Não | 2 | Situação Tributária | |
QUANTIDADE | Numérico | Sim | 12 | 999999999999 | Quantidade |
VALORUNITARIO | Numérico | Sim | 12 | 999999999,99 | Valor Unitário |
VALORTOTAL | Numérico | Sim | 12 | 999999999,99 | Valor Total do Item |
ALIQUOTAICMS | Numérico | Não | 6 | 999,99 | Alíquota ICMS |
ALIQUOTAIPI | Numérico | Não | 6 | 999,99 | Alíquota IPI |
IPI | Numérico | Não | 12 | 999999999,99 | IPI |
VALORDESCONTO | Numérico | Não | 12 | 999999999,99 | Valor do Desconto por Item |
PORCENTUALDESCONTO | Numérico | Não | 6 | 999,99 | Desconto - % |
DESCONTO | Numérico | Não | 12 | 999999999,99 | Valor Total do Desconto |
TOTALLIQUIDO | Numérico | Sim | 12 | 999999999,99 | Valor Total Líquido |
TIPOPRODUTO | Texto | Sim | 1 | Produto = P / Serviço = S | |
QUANTIDADEATENDIDA | Numérico | Sim | 12 | 999999999999 | Quantidade Atendida para este Item Caso haja corte o valor retornado será ZERO |
IDNOTAFISCAL | Numérico | Sim | 12 | 999999999999 | Identificador da Notafiscal - Corporativo g-com |
NUMEROSERIE | Texto | Não | 20 | Para saída de um produto com número de série especifico, deve ser informado o número. | |
TIPOMATERIAL | Numérico | Não | 12 | 999999999999 | Identifica o tipo do produto : Lote, patrimônio, etc |
ST3 | Texto | Não | 10 | Situação Tributária com 3 dígitos | |
INSCRICAOESTEMITENTE | Texto | Não | 21 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
DATAVENCIMENTOLOTE | Data | Não | 10 | DD/MM/AAAA | Data vencimento do lote |
DESCRICAOREDUZIDA | Texto | Não | 6 | Será obrigatório apenas se o depositante estiver configurado para importar o produto validando a descrição reduzida Sigla resumida da embalagem. Ex: CX, UN, DP | |
IDITEMERP | Texto | Não | 500 | Identificador do Item do Documento enviado pelo ERP | |
VALORICMSDESONERADO | Numérico | Não | 12 | 000000000,00 | Valor ICMS desonerado |
CODIGOPRODUTOANVISA | Texto | Não | 13 | Código ANVISA do produto | |
PRECOMAXIMOCONSUMIDOR | Numérico | Não | 13 | 9999999999,99 | Preço Máximo Consumidor |
BASEICMS | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS |
VALORICMS | Numérico | Não | 12 | 000000000,00 | Valor ICMS |
IMPORTACAOCOBFISCAL | Texto | Não | 1 | Indica se a importação foi realizada por cobertura fiscal. Sim(S) / Não(N) | |
ALIQUOTAPIS | Numérico | Não | 6 | 999,99 | Alíquota PIS |
BASEPIS | Numérico | Não | 12 | Base PIS | |
VALORPIS | Numérico | Não | 12 | PIS | |
ALIQUOTACOFINS | Numérico | Não | 6 | 999,99 | Alíquota COFINS |
BASECOFINS | Numérico | Não | 12 | Base COFINS | |
VALORCOFINS | Numérico | Não | 12 | COFINS | |
ORIGEMPRODUTO | Texto | Não | Origem do produto | ||
REMESSA | Texto | Não | 20 | Número de remessa a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
NOTAFISCAL | Texto | Não | 20 | Número de nota fiscal a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
SERIENF | Texto | Não | 20 | Número de série da nota fiscal a qual o item pertence no ERP (utilizado quando o pedido ou nota do WMS representa várias notas no ERP) | |
TIPOPTL | Texto | Não | 10 | Indica qual é a linha de PTL onde o item deve ser separado quando o pedido ou nota for marcado como PTL. Representa o código de PTL da Região de Armazenagem | |
TIPOCAIXASEP | Texto | Não | 20 | Indica ao sistema de PTL qual é o tipo de caixa de separação que deve ser utilizado para a geração do volume pelo mesmo | |
VOLUMECAIXA | Numérico | Não | 12 | Indica ao sistema de PTL qual é o número de volume que deve ser utilizado para a sua geração, indicando que os materiais devem ser isolados em determinado volume | |
MENSAGEMCAIXA | Texto | Não | 30 | Indica ao sistema de PTL qual é a mensagem que deve ser impressa ao destinatário para casos de mensagem de presente por exemplo | |
CODSETOR | Texto | Não | 100 | Código de Depósito informado pelo ERP | |
MOTIVOISENCAO | Texto | Não | 255 | Motivo da isenção da ANVISA. Para medicamento isento de registro na ANVISA deve informar o número da decisão que o isenta | |
NUMEROORDEMCOMPRA | Texto | Não | 40 | Número Ordem de Compra | |
OBSITEMSEPARACAO | Texto | Não | 999 | Observação deixada pelo cliente em seu pedido especifico para cada item. Ex: Nome: Cliente, Numero: 10 |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CHAVE | Texto | Sim | 20 | Campo de personalização | |
CODIGOINTERNO | Texto | Sim | 20 | Valor do campo de personalização |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
NUMERONF | Texto | Sim | 60 | Número da Nota Fiscal. Deve ser igual ao campo “codigoInterno” informado no pedido principal | |
SERIENF | Texto | Não | 20 | Série da Nota Fiscal. Apesar de não obrigatório deve ser enviado o que foi informado no campo “sequência” no pedido principal | |
LOTE | Texto | Não | 10 | Lote Indústria utilizado na conferência | |
DATAVALIDADE | Texto | Não | 20 | Data de Validade do Lote | |
DATAFABRICACAO | Texto | Não | 20 | Data de Fabricação do Lote | |
CODIGOPRODUTO | Texto | Não | 13 | Código Interno do Produto | |
QUANTIDADE | Numérico | Sim | 12 | 999999999999 | Quantidade conferencia do lote |
IDSEQ | Numérico | Sim | 12 | IDSEQUENCIA de envio do produto | |
IDSEQCFE | Numérico | Não | 12 | IDSEQUENCIA de envio da conferência específica |
Response
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Para que o ERP faça a gestão de documentos (Pedido/Nota Fiscal) enviados para Expedição, ou seja, documentos de saída, o WMS Senior disponibiliza a exportação de Mudança de Status do Documento, permitindo que ambos os sistemas tenham as mesmas informações do Pedido/Nota Fiscal. Essa exportação é realizada nas seguintes movimentações do documento:
- Aguardando Formação de Onda
- Aguardando Separação
- Separação Iniciada
- Aguardando Resolução de Quebra
- Separação Concluída
- Packing Iniciado
- Packing Concluído
- Enviado para Faturamento
- Coleta Iniciada
- Expedido
- Cancelado
- Quarentena
- Digitado / Importado / Removido Quarentena
tipointegração: EXPORTACAO_ANDAMENTODOC_REST
Request
{ "chavelayout" : "vi_int_envio_andamentodoc", "list" : [ { "codigointerno" : "", "numpedido" : "", "cnpjdepositante" : "", "cnpjemitente" : "", "sequencia" : "", "tipo" : "", "datahora" : "", "dataintegracao" : "", "idnotafiscal" : "", "situacao" : "", "idprocessointegracao" : "" } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
ID | Numérico | Não | 12 | Chave de integração | |
CODIGOINTERNO | Texto | Não | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Não | 20 | 99999999999999999999 | Número do Pedido |
CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJEMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
TIPO | Texto | Não | 1 | Entrada = E / Saída = S | |
DATAHORA | Texto | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data/Hora que ocorreu a mudança da situação do documento |
DATAINTEGRACAO | Data | Não | 10 | Data do processamento da integração pelo sistema de terceiros | |
IDNOTAFISCAL | Numérico | Não | 12 | Número do Identificador da NotaFiscal | |
SITUACAO | Numérico | Não | 2 | Indica o status de movimentacão do documento de saida. Situacão do Pedido/NotaFiscal.(0) Aguardando Formacão de Onda;(1) Aguardando Separacão;(2) Separacão Iniciada;(3) Aguardando Resolucão de Quebra;(4) Separacão Concluida;(5) Packing Iniciado;(6) Packing Concluido;(7) Enviado Para Faturamento;(8) Coleta Iniciada;(9) Expedido;(10) Cancelado;(11) Quarentena;(12) Digitado / Importado / Removido Quarentena | |
IDPROCESSOINTEGRACAO | Texto | Não | 50 | Identificador único no processo de integração com o ERP Senior |
Faturamento
tipointegração:
- EXPORT_FATURAMENTO_LOTE_REST
- EXPORT_FATURAMENTODET_LOTE_REST
- EXPORT_FATURAMENTOESPEC_LOTE_REST
Após a Separação ou Conferência do material, o WMS Senior realiza a comunicação com o ERP através da interface de Retorno de Faturamento, solicitando ao ERP que realize o faturamento e envie as informações de Faturamento para o WMS Senior.
Request
{ "chavelayout" : "vi_int_envio_fatur_lote", "list" : [ { "codigointerno" : "", "numpedido" : "", "cnpj_depositante" : "", "cnpj_emitente" : "", "sequencia" : "", "tipo" : "", "status" : "", "o" : "", "motivocancelamento" : "", "c" : "", "idmovimento" : "", "idnotafiscal" : "", "npalet" : "", "seq_entrega" : "", "paginageomapa" : "", "descrromaneio" : "", "placa" : "", "motorista" : "", "cnpj_motorista" : "", "dataemissao" : "", "qtdevolume" : "", "totalpesovolume" : "", "cnpj_dest" : "", "identificadorpedido" : "", "totalcubagemvolume" : "", "codigotipopedido" : "", "tipoenvio" : "", "especievolume" : "", "datafaturamento" : "", "datafaturamentosegmomento" : "", "itens" : [ { "chavelayout" : "vi_int_envio_fatur_det_lote", "i" : "", "codigointerno" : "", "numpedido" : "", "cnpj_depositante" : "", "cnpj_emitente" : "", "sequencia" : "", "tipo" : "", "idseq" : "", "barra" : "", "qtde" : "", "qtdeatendida" : "", "idnotafiscal" : "", "codigoproduto" : "", "idenficadorpedido" : "", "qtdecortefisico" : "", "volumes" : "", "lote" : "", "barraemb" : "", "vlrunit" : "", "pesobruto" : "", "vencimento" : "", "fabricacao" : "", "barravolume" : "", "palletcaixacoletiva" : "", "numerocaixacoletiva" : "", "seriecaixacoletiva" : "", "desccaixaseparacao" : "", "nfentrada" : "", "serienfentrada" : "", "cnpjemitentenfentrada" : "", "tipoenvio" : "", "idnfdet" : "", "pesobrutounitario" : "", "pesoliquidounitario" : "", "motivocorte" : "", "infoEsp" : [ { "chavelayout" : "vi_int_envio_fatur_spec_lote", "codigointerno" : "", "sequencia" : "", "numpedido" : "", "cnpj_depositante" : "", "cnpj_emitente" : "", "idseq" : "", "codigoproduto" : "", "barra" : "", "idnfdet" : "", "informacaoespecifica" : "", "valor" : "", "barraemb" : "", "tipoenvio" : "", "barravolume" : "" } ] } ] } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
I | Numérico | Não | 1 | 6 | Valor Fixo |
CODIGOINTERNO | Texto | Não | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Não | 20 | 99999999999999999999 | Número do Pedido |
CNPJ_DEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJ_EMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
TIPO | Texto | Não | 1 | Entrada = E / Saída = S | |
STATUS | Texto | Não | 1 | Andamento (A) ou Concluído (C) - Indica se o faturamento está em andamento (A) e ao exportar todos os itens, Indica que o envio de faturamento foi concluído (C) | |
O | Texto | Não | 1 | Origem Wms ou Corporativo | |
MOTIVOCANCELAMENTO | Texto | Não | 100 | Motivo do Estorno/Cancelamento | |
C | Texto | Não | 1 | Cancelado (sim ou não) | |
IDMOVIMENTO | Numérico | Não | 20 | Número da OR nas Entradas/ Saídas IDRomaneio | |
IDNOTAFISCAL | Numérico | Não | 20 | Identificador do pedido (id) enviado pelo ERP | |
NPALET | Texto | Não | 150 | Numero dos Paletes na Entrega | |
SEQ_ENTREGA | Texto | Não | 20 | Seqüência da Entrega | |
PAGINAGEOMAPA | Texto | Não | 10 | Setor do Cliente ou Rota do Cliente | |
DESCRROMANEIO | Texto | Não | 80 | Descrição do Romaneio de Separação | |
PLACA | Texto | Não | 10 | Placa do Veículo | |
MOTORISTA | Texto | Não | 80 | Motorista do Veículo | |
CNPJ_MOTORISTA | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Motorista |
DATAEMISSAO | Texto | Não | 10 | Data Emissão do Pedido | |
QTDEVOLUME | Numérico | Não | 10 | Qtde de volumes da nota fiscal | |
TOTALPESOVOLUME | Numérico | Não | 10 | Total do peso dos volumes da nota fiscal | |
CNPJ_DEST | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Destinatário |
IDENTIFICADORPEDIDO | Numérico | Não | 12 | Identificador do Pedido do Packing | |
TOTALCUBAGEMVOLUME | Numérico | Não | 10 | Total da cubagem dos volumes da nota fiscal | |
F | Texto | Não | 1 | Campo não deverá ser utilizado como final de registro. NUNCA deverá ser movido. | |
CODIGOTIPOPEDIDO | Texto | Não | 100 | Indica a classificação do tipo do pedido | |
TIPOENVIO | Numérico | Não | 1 | Tipo envio | |
ESPECIEVOLUME | Texto | Não | 50 | Código de Integração do Tipo de Caixa do Volume | |
DATAFATURAMENTO | Texto | Não | 19 | DD/MM/AAAA HH:MI:SS | Data e Hora de Envio para Faturamento |
DATAFATURAMENTOSEGMOMENTO | Texto | Não | 19 | DD/MM/AAAA HH:MI:SS | Data e Hora de Envio para Faturamento no segundo momento |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
I | Numérico | Não | 1 | 7 | Valor Fixo |
CODIGOINTERNO | Texto | Não | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Não | 20 | 99999999999999999999 | Número do Pedido |
CNPJ_DEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJ_EMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
TIPO | Texto | Não | 1 | Entrada = E / Saída = S | |
IDSEQ | Numérico | Não | 12 | 999999999999 | Sequência do Item (Ordem de impressão dos itens) |
BARRA | Texto | Não | 20 | Código de Barras do Produto (exporta apenas se tiver 20 caracteres ou menos) | |
QTDE | Numérico | Não | 12 | 999999999999 | Quantidade |
QTDEATENDIDA | Numérico | Não | 12 | 999999999999 | Quantidade Atendida para este Item na Liberação para Roteirização. |
IDNOTAFISCAL | Numérico | Não | 12 | Identificador da Nota Fiscal. Antigo idGcom | |
CODIGOPRODUTO | Texto | Não | 60 | 999999999999 | Código do Produto - Sistema Corporativo |
IDENFICADORPEDIDO | Texto | Não | 12 | Identificador do Pedido do Packing | |
QTDECORTEFISICO | Numérico | Não | 12 | Indica a quantidade que foi reportado falta do item da nota durante a separação | |
VOLUMES | Texto | Não | 200 | Indica em qual ou em quais volumes está o produto da nota fiscal | |
LOTE | Texto | Não | 20 | Lote Indústria | |
BARRAEMB | Texto | Não | 32 | Código de Barras do Produto com 32 caracteres | |
VLRUNIT | Numérico | Não | 12 | 000000000,00 | Indica o valor do item |
PESOBRUTO | Numérico | Não | 12 | 0000000,0000 | Indica o peso bruto do item (kg) |
VENCIMENTO | Data | Não | 10 | Data do Vencimento do Lote | |
FABRICACAO | Data | Não | 10 | Data de Fabricação do Lote | |
BARRAVOLUME | Texto | Não | 32 | Barra do Volume (quando envia faturamento com apenas um volume por linha) | |
PALLETCAIXACOLETIVA | Texto | Não | 48 | Identificação do pallet da caixa de coletiva *. | |
NUMEROCAIXACOLETIVA | Texto | Não | 10 | Identificação do número da caixa coletiva *. | |
SERIECAIXACOLETIVA | Texto | Não | 30 | Identificação da série da caixa coletiva *. | |
DESCCAIXASEPARACAO | Texto | Não | 100 | Identificação da caixa de separação *. | |
NFENTRADA | Texto | Não | 20 | Codigo Interno da Nota Fiscal de Entrada | |
SERIENFENTRADA | Texto | Não | 20 | Serie da Nota Fiscal de Entrada | |
CNPJEMITENTENFENTRADA | Texto | Não | 20 | CNPJ/CPF do Emitente da Nota Fiscal de Entrada | |
TIPOENVIO | Numérico | Não | 1 | 0 - Não / 1 - Sim | Indica se o envio é apenas informativo de faturamento. 0 - Nao, 1 - Sim |
IDNFDET | Numérico | Não | 20 | Identificador item | |
PESOBRUTOUNITARIO | Numérico | Não | 12 | Indica o peso bruto unitário no cadastro de embalagem | |
PESOLIQUIDOUNITARIO | Numérico | Não | 12 | Indica o peso líquido unitário no cadastro de embalagem | |
MOTIVOCORTE | Texto | Não | 200 | Indica o motivo do corte |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CODIGOINTERNO | Texto | Não | 20 | 99999999999999999999 | Número da Nota Fiscal |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
NUMPEDIDO | Texto | Não | 20 | 99999999999999999999 | Número do Pedido |
CNPJ_DEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJ_EMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
IDSEQ | Numérico | Não | 12 | 999999999999 | Sequência do Item (Ordem de impressão dos itens) |
CODIGOPRODUTO | Texto | Não | 20 | 999999999999 | Código do Produto - Sistema Corporativo |
BARRA | Texto | Não | 20 | Código de Barras do Produto (exporta apenas se tiver 20 caracteres ou menos) | |
IDNFDET | Numérico | Não | 12 | Identificador do item da nota | |
INFORMACAOESPECIFICA | Texto | Não | 200 | Descrição da informação específica | |
VALOR | Texto | Não | 200 | Valor da informação específica | |
BARRAEMB | Texto | Não | 32 | Código de Barras do Produto com 32 caracteres | |
TIPOENVIO | Numérico | Não | 1 | 0 - Não / 1 - Sim | Indica se o envio é apenas informativo de faturamento. 0 - Nao, 1 - Sim |
BARRAVOLUME | Texto | Não | 32 | Barra do Volume (quando envia faturamento com apenas um volume por linha) |
O endpoint para a integração de Faturamento no fluxo de Expedição do WMS Senior é essencial para que o fluxo de expedição possa ser finalizado. A comunicação neste endpoint é assíncrona, ou seja, no Response (da requisição de cadastro) é informado um número de protocolo que pode ser utilizado posteriormente para consultar o status (erro, sucesso, agendado) no Log de Integração.
Request
{ "codigoInterno":"", "numPedido":"", "cnpjDepositante":"", "cnpjEmitente":"", "sequencia":"", "tipo":"", "dataEmissao":"", "baseIcms":0, "valorIcms":0, "baseSubstituicao":0, "valorSubstituicao":0, "frete":0, "seguro":0, "despesasAcessorias":0, "ipi":0, "valorProdutos":0, "valorTotal":0, "nomeTransportadora":"", "cnpjTransportadora":"", "enderecoTransportadora":"", "numeroEndTransportadora":"", "bairroTransportadora":"", "cidadeTransportadora":"", "ufTransportadora":"", "cepTransportadora":"", "inscricaoEstadualTransportadora":"", "cifFob":"", "veiculo":"", "ufVeiculo":"", "qtde":0, "especie":"", "marca":"", "numero":"", "pesoLiquido":0, "pis":0, "cofins":0, "cs":0, "ir":0, "valorIss":0, "valorServicos":0, "idMovimento":0, "tipoDocumento":"", "numItens":0, "tipoNf":"", "dataColeta":"", "horaColeta":"", "observacao":"", "chaveIdentificacaoExt":"", "chaveAcessoNFE":"", "sequenciaPed":"", "cnpjTranspRedespacho":"", "dataImpExp":"", "inscricaoEstEmitente":"", "codigoServicoTransportadora":"", "cfop":"", "descrOper":"", "valorIcmsDesonerado":0, "presencaComprador":"", "formaPagamento":"", "protocoloNfe":"", "dataRecebimentoNfe":"", "utilizaZPL": "", "codigoRastreio": "", "codigoServicoEtiquetaExterna": "", "observacaoSeparacao": "", "itens":[ { "codigoInterno":"", "numPedido":"", "cnpjDepositante":"", "cnpjEmitente":"", "sequencia":"", "tipo":"", "idSeq":0, "codigoIndustria":"", "descricaoProduto":"", "barraProduto":"", "classificacaoFiscal":"", "st":"", "valorUnitario":0, "valorTotal":0, "aliquotaICMS":0, "aliquotaIPI":0, "ipi":0, "valorDesconto":0, "porcentualDesconto":0, "desconto":0, "totalLiquido":0, "tipoProduto":"", "idNotaFiscal":"", "numeroSerie":"", "tipoMaterial":"", "st3":"", "baseICMSsubst":0, "baseSubSt":0, "despesaAcessoria":0, "aliqIcmsSt":0, "reducaoIcms":0, "classeIpi":"", "codigoSeloIpi":"", "qtdeSeloIpi":0, "codigoIpi":"", "cstIpi":"", "bcIpi":0, "valorBcIi":0, "valorDespAduaneiras":0, "valorIi":0, "valorIiOperFinanceiras":0, "cstPis":0, "bcPis":0, "aliqPis":0, "cstCofins":0, "bcCofins":0, "aliqCofins":0, "baseIcms":0, "valorIcms":0, "frete":0, "seguro":0, "pis":0, "cofins":0, "cfop":"", "inscEstadualEmitente":"", "descrReduzido":"", "qtdeAtendida":0, "valorIcmsDesonerado":0, "codigoProdAnvisa":"", "precoMaxConsumidor":0, "motivoIsencao":"", "icmsSubst":0 } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Sim | 20 | 99999999999999999999 | Número do Pedido |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Sim | 20 | Série da Nota Fiscal | |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S | |
DATAEMISSAO | Data | Sim | 10 | DD/MM/AAAA | Data da Nota Fiscal |
BASEICMS | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS |
VALORICMS | Numérico | Não | 12 | 000000000,00 | Valor ICMS |
BASESUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Base de Cálculo do ICMS Substituição |
VALORSUBSTITUICAO | Numérico | Não | 12 | 000000000,00 | Valor do ICMS Substituição |
FRETE | Numérico | Não | 12 | 000000000,00 | Valor do Frete |
SEGURO | Numérico | Não | 12 | 000000000,00 | Valor do Seguro |
DESPESASACESSORIAS | Numérico | Não | 12 | 000000000,00 | Outras Despesas Acessórias |
IPI | Numérico | Não | 12 | 000000000,00 | Valor Total do IPI |
VALORPRODUTOS | Numérico | Sim | 12 | 000000000,00 | Valor Total dos Produtos |
VALORTOTAL | Numérico | Sim | 12 | 000000000,00 | Valor Total da Nota |
NOMETRANSPORTADORA | Texto | Sim | 60 | Transportadora - Razão Social | |
CNPJTRANSPORTADORA | Texto | Sim | 20 | 99.999.999/9999-99 | Transportadora - CNPJ |
ENDERECOTRANSPORTADORA | Texto | Sim | 80 | Transportadora - Endereço | |
NUMEROENDTRANSPORTADORA | Texto | Sim | 10 | Transportadora - Endereço Número | |
BAIRROTRANSPORTADORA | Texto | Sim | 50 | Transportadora - Bairro | |
CIDADETRANSPORTADORA | Texto | Sim | 60 | Transportadora - Cidade | |
UFTRANSPORTADORA | Texto | Sim | 2 | Transportadora - Estado | |
CEPTRANSPORTADORA | Texto | Sim | 8 | 99999999 | Transportadora - CEP |
INSCRICAOESTADUALTRANSPORTADORA | Texto | Sim | 20 | Transportadora - Inscrição Estadual | |
CIFFOB | Texto | Sim | 1 | Transportadora - Modalidade do Frete Por Conta: (1) Contratação do Frete por conta do Remetente (CIF), (2) Contratação do Frete por conta do Destinatário (FOB), (4) Contratação do Frete por conta de Terceiros, (5)Sem Ocorrência de Transporte, (6)Transporte Próprio por conta do Remetente e (7)Transporte Próprio por conta do Destinatário | |
VEICULO | Texto | Não | 20 | Transportadora - Placa do Veículo | |
UFVEICULO | Texto | Não | 2 | Transportadora - Estado | |
QTDE | Numérico | Não | 12 | 999999999999 | Transportadora - Quantidade |
ESPECIE | Texto | Não | 20 | Transportadora - Espécie | |
MARCA | Texto | Não | 20 | Transportadora - Marca | |
NUMERO | Texto | Não | 60 | Transportadora - Número | |
PESOLIQUIDO | Numérico | Sim | 12 | 999999999999 | Transportadora - Peso Líquido (gramas) |
PIS | Numérico | Não | 12 | 000000000,00 | PIS |
COFINS | Numérico | Não | 12 | 000000000,00 | COFINS |
CS | Numérico | Não | 12 | 000000000,00 | Contribuição Social |
IR | Numérico | Não | 12 | 000000000,00 | Imposto de Renda |
VALORISS | Numérico | Não | 12 | 000000000,00 | Valor do ISS |
VALORSERVICOS | Numérico | Não | 12 | 000000000,00 | Valor do Serviço |
IDMOVIMENTO | Numérico | Não | 12 | 999999999999 | Faz referência à OR caso seja de entrada e a onda caso seja de saída, se houver integração com a nota fiscal. |
TIPODOCUMENTO | Texto | Não | 1 | Tipo do Documento Cobranca deve ser D, C, B, X ou T | |
NUMITENS | Numérico | Sim | 12 | 000000000,00 | Número de itens |
TIPONF | Texto | Sim | 60 | Pedido/Notafiscal | Indica se o Registro é um Pedido (P) ou uma Nota Fiscal (N) |
DATACOLETA | Data | Não | 10 | Data prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. | |
HORACOLETA | Hora | Não | 8 | Hora prevista para retirada da transportadora. Informação correspondente a Data Esperada para Embarque. | |
OBSERVACAO | Texto | Não | 4000 | Texto livre | Dados adicionais |
CHAVEIDENTIFICACAOEXT | Texto | Não | 20 | Texto livre | Chave de identificação externa do documento |
CHAVEACESSONFE | Texto | Não | 44 | Indica a chave de acesso da NFe. | |
SEQUENCIAPED | Texto | Não | 20 | Enviado apenas no arquivo de faturamento (ANF) caso a sequência da nota fiscal seja diferente da sequência do pedido | |
CNPJTRANSPREDESPACHO | Texto | Não | 20 | 99.999.999/9999-99 | Transportadora Redespacho - CNPJ |
DATAIMPEXP | Data | Não | 20 | ||
INSCRICAOESTEMITENTE | Texto | Não | 21 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
CODIGOSERVICOTRANSPORTADORA | Texto | Não | 60 | Indica o código de serviço a ser utilizado pela transportadora | |
CFOP | Texto | Não | 5 | CFOP | |
DESCROPER | Texto | Não | 100 | Descrição da Operação | |
VALORICMSDESONERADO | Numérico | Não | 12 | 000000000,00 | Valor ICMS Desonerado |
PRESENCACOMPRADOR | Texto | Não | 12 | 0 - Não se aplica (por exemplo, Nota Fiscal complementar ou de ajuste) - (0); 1 - Operação presencial - (1); 2 - Operação não presencial, pela Internet - (2); 3 - Operação não presencial, Teleatendimento - (3); 4 - NFC-e em operação com entrega a domicílio - (4); 5 - Operação presencial fora do estabelecimento - (5); 6- Operação não presencial, outros. - (9) | |
FORMAPAGAMENTO | Texto | Não | 12 | Forma de pagamento: | |
PROTOCOLONFE | Texto | Não | 20 | Protocolo da nota fiscal eletrônica. | |
DATARECEBIMENTONFE | Texto | Não | 22 | DD/MM/YYYY HH24:MI:SS | Data de recebimento do Protocolo da NFE |
UTILIZAZPL | Numérico | Não | 1 | Indica se a nota fiscal utiliza etiqueta externa do tipo ZPL. 0 - Não, 1 - Sim. | |
CODIGORASTREIO | Texto | Não | 25 | Código de rastreio do volume onde os itens da nota se encontram. | |
CODSERVETIQEXT | Texto | Não | 100 | Código de integração com Serviço de Etiqueta Externa. Quando utiliza ZPL. | |
OBSSEPARACAO | Texto | Não | 500 | Observação deixada pelo cliente em seu pedido. Ex: Solicito colocar o nome abaixo do numero. |
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CODIGOINTERNO | Texto | Sim | 20 | 99999999999999999999 | Número da Nota Fiscal |
NUMPEDIDO | Texto | Sim | 20 | 99999999999999999999 | Número do Pedido |
CNPJDEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CNPJEMITENTE | Texto | Sim | 20 | 99.999.999/9999-99 | Saída=CNPJ Depositante / Entrada=CNPJ Fornecedor |
SEQUENCIA | Texto | Não | 20 | Série da Nota Fiscal | |
TIPO | Texto | Sim | 1 | Entrada = E / Saída = S | |
IDSEQ | Numérico | Sim | 12 | 999999999999 | Sequência do Item (Ordem de impressão dos itens) |
CODIGOINDUSTRIA | Texto | Não | 60 | Código Interno do Produto - Depositante | |
DESCRICAOPRODUTO | Texto | Sim | 120 | Descrição do Produto | |
BARRAPRODUTO | Texto | Sim | 30 | Código de Barras do Produto | |
CLASSIFICACAOFISCAL | Texto | Não | 5 | Classificação Fiscal do Produto | |
ST | Texto | Não | 20 | Situação Tributária | |
VALORUNITARIO | Numérico | Não | 12 | 999999999,99 | Valor Unitário |
VALORTOTAL | Numérico | Não | 12 | 999999999,99 | Valor Total do Item |
ALIQUOTAICMS | Numérico | Não | 6 | 999,99 | Alíquota ICMS |
ALIQUOTAIPI | Numérico | Não | 6 | 999,99 | Alíquota IPI |
IPI | Numérico | Não | 12 | 999999999,99 | IPI |
VALORDESCONTO | Numérico | Não | 12 | 999999999,99 | Valor do Desconto por Item |
PORCENTUALDESCONTO | Numérico | Não | 6 | 999,99 | Desconto - % |
DESCONTO | Numérico | Não | 12 | 999999999,99 | Valor Total do Desconto |
TOTALLIQUIDO | Numérico | Não | 12 | 999999999,99 | Valor Total Líquido |
TIPOPRODUTO | Texto | Sim | 1 | Produto = P / Serviço = S | |
IDNOTAFISCAL | Texto | Não | 20 | 999999999999 | Identificador da Notafiscal - Corporativo g-com |
NUMEROSERIE | Texto | Não | 20 | Para saída de um produto com número de série especifico, deve ser informado o número | |
TIPOMATERIAL | Texto | Não | 20 | 999999999999 | Identifica o tipo do produto : Lote, patrimônio, etc |
ST3 | Texto | Não | 3 | Situação Tributária com 3 dígitos | |
BASEICMSSUBST | Numérico | Não | 12 | 999,99 | Base de cálculo do ICMS subistituição |
BASESUBST | Numérico | Não | 12 | 999,99 | Base Situação Tributária |
DESPESAACESSORIA | Numérico | Não | 12 | Valor de despesas acessorias | |
ALIQICMSST | Numérico | Não | 6 | Aliquota de ICMS ST | |
REDUCAOICMS | Numérico | Não | 12 | % redução ICMS | |
CLASSEIPI | Texto | Não | 5 | Classe de enquadramento do IPI | |
CODIGOSELOIPI | Texto | Não | 60 | Codigo de selo de controle de IPI | |
QTDESELOIPI | Numérico | Não | 12 | Quantidade de selos de controle de IPI | |
CODIGOIPI | Texto | Não | 3 | Codigo de enquadramento de IPI | |
CSTIPI | Texto | Não | 2 | CST(Codigo de Situação Tributaria) de IPI | |
BCIPI | Numérico | Não | 12 | BC(Base de Calculo) do IPI | |
VALORBCII | Numérico | Não | 12 | Valor Base de calculo do Imposto de Importação | |
VALORDESPADUANEIRAS | Numérico | Não | 12 | Despesas Aduaneiras do produto | |
VALORII | Numérico | Não | 12 | Valor do II | |
VALORIIOPERFINANCEIRAS | Numérico | Não | 12 | Valor do II sobre Operações Financeiras de Importação | |
CSTPIS | Numérico | Não | 12 | Código da Situação Tributária PIS | |
BCPIS | Numérico | Não | 12 | Base de Cálculo PIS | |
ALIQPIS | Numérico | Não | 6 | Alíquota PIS | |
CSTCOFINS | Numérico | Não | 12 | Código da Situação Tributária COFINS | |
BCCOFINS | Numérico | Não | 12 | Base de Cálculo COFINS | |
ALIQCOFINS | Numérico | Não | 6 | Alíquota COFINS | |
BASEICMS | Numérico | Não | 12 | Base ICMS | |
VALORICMS | Numérico | Não | 12 | Valor ICMS | |
FRETE | Numérico | Não | 12 | Valor do Frete | |
SEGURO | Numérico | Não | 12 | Valor do Seguro | |
PIS | Numérico | Não | 12 | PIS | |
COFINS | Numérico | Não | 12 | COFINS | |
CFOP | Texto | Não | 4 | CFOP | |
INSCESTADUALEMITENTE | Texto | Não | 20 | Emitente - Inscrição Estadual / Quando existir um depositante com mesmo CNPJ e mais de uma IE, aí a IE se torna obrigatória para o sistema. | |
DESCRREDUZIDO | Texto | Não | 6 | Descrição Reduzida | |
QTDEATENDIDA | Numérico | Não | 12 | 999999999999 | Quantidade Atendida para este Item |
VALORICMSDESONERADO | Numérico | Não | 12 | 0000000000,00 | Valor ICMS Desonerado |
CODIGOPRODANVISA | Texto | Não | 13 | Código ANVISA do produto | |
PRECOMAXCONSUMIDOR | Numérico | Não | 12 | 9999999999,99 | Preço máximo consumidor |
MOTIVOISENCAO | Texto | Não | 255 | Motivo da isenção da ANVISA. Para medicamento isento de registro na ANVISA deve informar o número da decisão que o isenta | |
ICMSSUBST | Numérico | Não | 12 | Substituição tributária do ICMS |
Response
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Request
O faturamento também pode ser feito através da integração do XML da nota fiscal, seguindo o mesmo modelo disponibilizado pela SEFAZ para NF-e.
Response
{ "sucesso": true, "mensagem": "XML da NF-e enviado com sucesso para importação", "protocolo": "214612570052_1700" }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Operacionais de Gestão de Estoque
tipointegração: EXP_SALDO_ESTOQUE_PRODUTO_REST_LOTE
Para que o ERP realize a gestão de estoque, o WMS Senior oferece a exportação diária do saldo de estoque. Isso permite que o ERP obtenha uma "Foto do Estoque", garantindo que ambos os sistemas possuam as mesmas informações de estoque. A seguir, são apresentadas as opções disponíveis para configuração no WMS Senior. Avalie durante a implementação qual método é mais adequado para sua operação.
Request
{ "chavelayout" : "vi_int_envio_estoque_lote", "list" : [ { "cnpjarmazem" : "", "cnpjdepositante" : "", "estoqueorigem" : "", "codigointerno" : "", "estoque" : "", "fatorconversao" : "", "descricao" : "", "loteindustria" : "", "datavencimento" : "", "vlrunit" : "", "estado" : "", "liberado" : "", "data" : "", "disponivel" : "", "codintegracaosetor" : "", "statuslote" : "", "estoqueunit" : "", "disponivelunit" : "" } ] }
Seq | Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|---|
1 | CNPJARMAZEM | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ do armazém do estoque origem. |
2 | CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ do depositante do produto. |
3 | ESTOQUEORIGEM | Texto | Não | 40 | Código de integração do setor do produto. | |
4 | CODIGOINTERNO | Texto | Não | 60 | Código interno do produto. | |
5 | ESTOQUE | Numérico | Não | 12 | 000000000000 | Quantidade estoque do produto |
6 | FATORCONVERSAO | Numérico | Não | 3 | Fator de conversão código de barras da caixa que o produto entrou no estoque | |
7 | DESCRICAO | Texto | Não | 80 | Descrição do produto | |
8 | LOTEINDUSTRIA | Texto | Não | 20 | Lote indústria do produto. | |
9 | DATAVENCIMENTO | Data | Não | 15 | DDMMAAAA | Data de vencimento do produto. |
10 | VLRUNIT | Numérico | Não | 12 | Valor unitário do produto. | |
11 | ESTADO | Texto | Não | 1 | Estado do produto. N- Normal; D - Danificado; T - Truncado/Vencido. | |
12 | LIBERADO | Texto | Não | 1 | Estoque liberado. S - Sim, N - Não. | |
13 | ID | Numérico | Não | 12 | Chave primária tabela. | |
14 | DATA | Data | Não | 10 | Data e hora da integração. | |
15 | AGRUPADOR | Numérico | Não | 12 | Agrupador de integração. | |
16 | DISPONIVEL | Numérico | Não | 30 | 000000000000 | Quantidade disponível do produto |
17 | CODINTEGRACAOSETOR | Texto | Não | 30 | Código de integração do setor do produto | |
18 | STATUSLOTE | Texto | Não | 30 | Status do lote. | |
19 | ESTOQUEUNIT | Numérico | Não | 12 | 000000000000 | Quantidade estoque unitário do produto |
20 | DISPONIVELUNIT | Numérico | Não | 12 | 000000000000 | Quantidade disponível unitário do produto |
Movimentação Interna
O endpoint para a integração de Bloqueio/Desbloqueio de Lote é utilizado para liberar ou bloquear a movimentação de um determinado lote. Por exemplo, um lote que tenha sido recebido em quarentena pode ter sua movimentação liberada após um processo de inspeção de qualidade. Da mesma forma, em casos de recall, um lote deve ser totalmente bloqueado para evitar que seja utilizado em separações ou na produção. Esse bloqueio ou desbloqueio pode ser realizado pelo WMS Senior ou solicitado pelo ERP ao WMS Senior.
Request
{ "chavelayout" : "int_bloq_desb_lote", "list" : [ { "cnpj_unidade" : "", "numero_notafiscal" : "", "serie_notafiscal" : "", "cnpj_emitente" : "", "cnpj_depositante" : "", "codigo_produto" : "", "lote_industria" : "", "vencimento" : "", "qtde_un" : 0, "acao" : 0, "motivo" : "", "codsetor" : "", "inscrestadual_emit" : "", "inscrestadual_dep" : "" } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CNPJ_UNIDADE | Texto | Sim | 20 | 99.999.999/9999-99 | Indica o armazém |
NUMERO_NOTAFISCAL | Texto | Não | 20 | Quando informado somente trabalha com lotes desta nota fiscal. Identifica o número da nota fiscal | |
SERIE_NOTAFISCAL | Texto | Não | 20 | Quando informado somente trabalha com lotes desta nota fiscal. Identifica a série da nota fiscal | |
CNPJ_EMITENTE | Texto | Não | 20 | 99.999.999/9999-99 | Quando informado somente trabalha com lotes desta nota fiscal. Identifica o emitente da nota fiscal |
CNPJ_DEPOSITANTE | Texto | Sim | 20 | 99.999.999/9999-99 | Identifica o depositante |
CODIGO_PRODUTO | Texto | Sim | 60 | Identifica o produto | |
LOTE_INDUSTRIA | Texto | Sim | 60 | Identifica o lote indústria | |
VENCIMENTO | Texto | Não | 10 | DD/MM/AAAA | Quando informado somente os lotes com este vencimento serão usados. Formato dd/mm/aaaa |
QTDE_UN | Numérico | Não | 9 | Quando informado indica a quantidade em unidade. Quando nulo, usa a quantidade total disponível do lote. | |
ACAO | Numérico | Sim | 1 | Identifica a ação a ser realizada. Bloqueio (0), Desbloqueio (1) | |
MOTIVO | Texto | Não | 100 | Indica o motivo de bloqueio ou desbloqueio. É um texto livre não obrigatório | |
CODSETOR | Texto | Não | 50 | Indica o código de integração do setor onde está armazenado o lote que será bloqueado | |
INSCRESTADUAL_EMIT | Texto | Não | 30 | Inscrição estadual do emitente | |
INSCRESTADUAL_DEP | Texto | Não | 30 | Inscrição estadual do depositante |
Response
{ "headers": {}, "body": { "mensagem": "Integração agendada com sucesso.", "protocolo": "300" }, "statusCode": "CREATED", "statusCodeValue": 201 }
{ "headers": {}, "body": { "mensagem": "Configuração integração não encontrada pelo ApiKey, operação cancelada." }, "statusCode": "UNAUTHORIZED", "statusCodeValue": 401 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Response
{ "headers": {}, "body": { "mensagem": "Integração realizada com sucesso.", "status": "sucesso" }, "statusCode": "OK", "statusCodeValue": 200 }
{ "headers": {}, "body": { "mensagem": "Protocolo não encontrado.", "status": "erro" }, "statusCode": "NOT_FOUND", "statusCodeValue": 404 }
{ "headers": {}, "body": { "mensagem": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
- O ERP Senior recebe somente UMA informação específica por produto, por exemplo - SÉRIE. Caso seja enviado mais de uma informação específica apresentará erro no ERP.
- O WMS não terá esta trava, enviará todas as informações específicas cadastradas no produto.
- Para obter dados:
- de vencimento
- o inventário confere vencimento
- o produto/depositante coleta vencimento - lote indústria
- o inventário confere lote indústria - código setor
- o setor/depositante com código de integração definido
- de vencimento
O inventário é realizado pelo Gestão de Armazenagem | WMS Senior, e por isso, é essencial comunicar ao ERP de terceiros as informações atualizadas de estoque. Abaixo estão as opções disponíveis para realizar a requisição que melhor se adapte à operação:
tipointegração: INTEGRACAO_INVENTARIO_LOTEINDUSTRIA_REST"Inventário (Lote Industria) - Via Rest")
Request
{ "chavelayout" : "vi_int_envio_inventario_lote", "list" : [ { "cnpjdepositante" : "", "codigointerno" : "", "estoque" : 0, "inventariado" : 0, "barra" : "", "descr" : "", "idinventario" : 0, "estado" : "", "lote" : "", "vencimento" : "", "fabricacaocalc" : "", "tipoinventario" : "", "codsetor" : "", "barraemb" : "" } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CODIGOINTERNO | Texto | Não | 20 | Código Interno do Produto | |
ESTOQUE | Numérico | Não | 12 | 000000000000 | Estoque do Sistema |
INVENTARIADO | Numérico | Não | 12 | 000000000000 | Inventariado |
BARRA | Texto | Não | 20 | Código de Barras do Produto | |
DESCR | Texto | Não | 80 | Descrição do Produto | |
IDINVENTARIO | Numérico | Não | 12 | Identificação do Inventário | |
ESTADO | Texto | Não | 2 | Estado do produto. N- Normal; D - Danificado; T - Truncado/Vencido. | |
LOTE | Texto | Não | 20 | Lote Indústria | |
VENCIMENTO | Data | Não | 10 | DD/MM/AAAA | Vencimento do Lote Indústria |
FABRICACAOCALC | Data | Não | 10 | DD/MM/AAAA | Data de Fabricação calculada do Lote Indústria |
TIPOINVENTARIO | Texto | Não | 1 | Indica se o inventário é do tipo Geral(G) ou do tipo Rotativo ou Cíclico (C) | |
CODSETOR | Texto | Não | 100 | Identifica o Código de Integração Definido no Vínculo entre Setor/Depositante | |
BARRAEMB | Texto | Não | 32 | Código de Barras do Produto com 32 caracteres |
tipointegração: INTEGRACAO_INVINFOESP_L_REST("Inventário (Info. Especifica, Lote Industria) - Via Rest")
Request
{ "chavelayout" : "vi_int_envio_invespec_lote", "list" : [ { "idinventario" : 0, "cnpjdepositante" : "", "codigointerno" : "", "descr" : "", "estado" : "", "informacao" : "", "valor" : "" } ] }
Campo | Formato | Obrigatoriedade | Tamanho | Máscara | Descrição |
---|---|---|---|---|---|
IDINVENTARIO | Numérico | Não | 12 | Identificação do Inventário | |
CNPJDEPOSITANTE | Texto | Não | 20 | 99.999.999/9999-99 | CNPJ Depositante |
CODIGOINTERNO | Texto | Não | 20 | Código interno do produto | |
DESCR | Texto | Não | 80 | Descrição do produto | |
ESTADO | Texto | Não | 1 | Estado do produto. N- Normal; D - Danificado; T - Truncado/Vencido. | |
INFORMACAO | Texto | Não | 100 | Informação específica (originada do cadastro de informações de material) selecionada no inventário/lote | |
VALOR | Texto | Não | 500 | Valores pertencentes a informação específica que é determinado no inventário/lote |