Integraciones ERP x WMS
- El objetivo central de integrar ERP y WMS en logística es asegurar que ambos sistemas se mantengan actualizados, reduciendo posibles fuentes de errores. Para ERP sénioracceder WMS Exportaciones x Senior ERP (Modelo V2).
Particularidades
Parametrizaciones
Integraciones
Importar/exportar banco a Bank.xls, incluida la versión 8.12
Integraciones Senior ERP x WMS (Modelo V1)
El punto final para la integración de entidades sigue las mismas reglas que la integración de banco a banco (INT_ENTITY), pero utilizando la estructura JSON.
Método: Publicar
URL: /webresources/rest/v2/entidade/integrar
Encabezados:
- Tipo de contenido: aplicación/JSON
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Envío
[ { "codeInternal": "", "persona": "", "cnpj": "", "inscrEstadual": "", "razaoSocial": "", "fantasia": "", "cep": "" , "dirección": "", "vecindario": "", "ciudad": "", "estado": "", "teléfono": "", "país": "", "número": "", "idForeigner": "", "foreigner": "", "cpf": "", "rg": "", "tipoEntidade": "", "inscricaoSuframa": "", "cnpjDepositante": "", " complement": "", "codEndereco": "", "codigoSorter": "", "endEntrega": "", "endCobranca": "", "active": "", "controleShelfLife": "", "valorShelfLife ": "", "idIntegracaoErp": "", "telefone2": "", "agente": "", "acrónimo": "", "personalizacaoCab": [ { "clave": "", "valor": "" } ] } ]
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| CODIGO INTERNO | Sí | Código interno de la entidad | |
| PERSONA | Sí | Tipo de persona (J o F) | |
| CNPJ | si el campo persona = J entonces es obligatorio | Entidad CNPJ | |
| INSCRESTADUAL | No | Registro estatal de la entidad. | |
| RAZÓN SOCIAL | Sí | Denominación social de la entidad | |
| FANTASÍA | No | Nombre comercial de la entidad | |
| CP ( Código Postal) | No | Código postal de la dirección de la entidad | |
| DIRECCIÓN | Sí | Dirección de la entidad | |
| VECINDARIO | No | Barrio del domicilio de la entidad | |
| CIUDAD | Sí | Ciudad de domicilio de la entidad | |
| ESTADO | Sí | Estado de la dirección de la entidad | |
| TELÉFONO | No | Número de teléfono de la entidad | |
| PAÍS | No | País de dirección de la entidad | |
| NÚMERO | No | Número de dirección de la entidad | |
| IDEAL EXTRANJERO | No | Código de Identificación de un Cliente Extranjero | |
| EXTRANJERO | Sí | Indica si la entidad es Extranjera. Sí (S) - No (N) | |
| CPF | si el campo persona = F entonces es obligatorio | 999.999.999-99 | Entidad CPF |
| RG | No | ID de entidad | |
| TIPOENTIDAD | Sí | Tipo de entidad. ejemplo: proveedor, cliente, depositante, transportista | |
| INSCRIPCIÓNSUFRAMA | No | Indica el Código en SUFRAMA (Superintendencia de la Zona Franca de Manaos) | |
| CNPJDEPOSITOR | No | 99.999.999/9999-99 | CNPJ del Depositante al que pertenece la entidad |
| COMPLEMENTAR | No | Complemento del domicilio de la Entidad | |
| CODENDERECO | No | 999999999999 | Código de dirección de la entidad del sistema integrador |
| CODIGOSORTADOR | No | Código de entidad de entrega en Clasificador (sistema) | |
| ENTREGA | Sí | Indica si la dirección es una dirección de entrega. Sí (S) - No (N) | |
| ENDCOBRANCA | Sí | Indica si la dirección es una dirección de facturación. Sí (S) - No (N) | |
| ACTIVO | Sí | Indica si la entidad está activa en el sistema. Sí (S) - No (N) | |
| CONTROL DE VIDA ÚTIL | No | Define cómo se utiliza la vida útil para enviar productos. 0 - No controla, 1 - En días naturales al vencimiento, 2 - Porcentaje de vida útil | |
| VALORESHELFIFE | No | 999999999999 | Determina el valor utilizado para controlar la vida útil. |
| IDINTEGRACAOERP | Sí | ||
| TELÉFONO2 | No | Segundo número de teléfono de la entidad | |
| AGENTE | Sí | Información adicional sobre la entidad. (N) No (S) Sí | |
| ACRÓNIMO | No | Acrónimo de la entidad. usado para sucursal |
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| LLAVE | No | Campo de personalización - Talla 50 | |
| VALOR | No | Valor del campo de personalización: tamaño 4999 |
Devolver:
{ "headers": { }, "body": { "message": "Integración programada correctamente.", "protocol": "9394" }, "statusCode": "CREADO", "statusCodeValue": 201 }
{ "headers": { }, "body": { "message": "No se encontró la configuración de integración a través de ApiKey y se canceló la operación". }, "statusCode": "NO AUTORIZADO", "statusCodeValue": 401 }
{ "headers": { }, "body": { "message": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Ejemplos
[ { "codigoInterno": "202108111", "pessoa": "F", "cnpj": "", "inscrEstadual": "", "razaoSocial": "Nombre de la empresa", "fantasia": "Fabiola", " cep": "14300-999", "dirección": "Rua das avencas, 999", "barrio": "jardim das samambaias", "ciudad": "Batatais", "estado": "SP", "teléfono" : "(16)99999-0999", "país": "BRASIL", "número": "190", "extranjero": "", "extranjero": "N", "cpf": "399.999.999- 99", "rg": "", "tipoEntidade": "", "inscricaoSuframa": "", "cnpjDepositante": "44.444.444/4444-44", "complement": "", "codeAddress": " 1", "codigoSorter": "", "endEntrega": "N", "endCobranca": "N", "ativo": "N", "controleShelfLife": "", "valorShelfLife": "", "idIntegracaoErp ": "", "personalizacaoCab": [ ] } ]
El punto final para la integración de entidades sigue las mismas reglas que la integración de banco a banco (INT_FATURAMENTO) y (INT_FATURAMENTODET), pero utilizando la estructura JSON.
Método: Publicar
URL: /webresources/rest/v2/invoicing/integrate
Encabezados:
- Tipo de contenido: aplicación/JSON
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Envío
{ "codeInterno" : "", "numPedido" : "", "cnpjDepositante" : "", "cnpjEmitente" : "", "sequencia" : "", "tipo" : "", "status" : "", "o" : "", "motivoCancellamento" : "", "c" : "", "idNotaFiscal" : null, "nPalet" : "", "seqEntrega" : "", "paginaGeoMapa" : "", "descrRomaneio " : "", "placa" : "", "driver" : "", "cnpjMotorista" : "", "dataEmission" : "", "qtyVolume" : "", "totalPesoVolume" : "", "cnpjDest" : "", "identificadorPedido" : "", "totalCubagemVolume" : "", "codigoTipoPedido" : "", "tipoEnvio" : "", "specieVolume" : "", "dataBilling" : "", "dateBillingSegMomento" : "", "items" : [ { "sequencia" : "", "idSeq" : "", "bar" : "", "cantidad" : 0, "quantidadeAtendida" : 0, "quantidadeCortePhysico" : 0, "codigoProduto " : "", "lote" : "", "barraEmb" : "", "vlrUnit" : 0, "pesoGruto" : 0, "vencimiento" : "", "fabricacao" : "", "palletCaixaColetiva" : " ", "numeroCaixaColetiva" : "", "serieCaixaColetiva" : "", "descCaixaSeparacao" : "", "identificadorPedido" : "", "volume" : "", "barVolume" : 0, "nfEntrada" : 0, " serieNfEntrada" : "", "cnpjEmitenteEntrada" : "", "idNfDet" : 0, "tipoEnvio" : "", "infEspecica" : [ { "idFaturamentoEspec" : 0, "informacaoEspeca" : "", "valor" : " " } ] } ] }
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| CODIGO INTERNO | Sí | 99999999999999999999 | Número de factura |
| NUMPEDIDO | Sí | 99999999999999999999 | Numéro del pedido |
| cnpjDepositor | Sí | 99.999.999/9999-99 | Depositante del CNPJ |
| cnpjEmisor | Sí | 99.999.999/9999-99 | Salida=Depositante CNPJ / Entrada=Proveedor CNPJ |
| SECUENCIA | No | Serie de la factura | |
| TIPO | Sí | Entrada = E / Salida = S | |
| FECHA DE EMISIÓN | Sí | DD/MM/AAAA | Fecha de la factura de impuestos |
| BASICOS | No | 000000000.00 | Base de cálculo del ICMS |
| VALORICOS | No | 000000000.00 | Valor IVA |
| REEMPLAZO DE BASES | No | 000000000.00 | Base de cálculo de reemplazo de ICMS |
| VALORES DE REEMPLAZO | No | 000000000.00 | Valor de reemplazo del ICMS |
| FLETE | No | 000000000.00 | Valor del Flete |
| SEGURO | No | 000000000.00 | Valor del seguro |
| GASTOS DE ACCESORIOS | No | 000000000.00 | Otros gastos accesorios |
| IPI | No | 000000000.00 | Valor total del IPI |
| valorProductos | Sí | 000000000.00 | Valor total de los productos |
| valor total | Sí | 000000000.00 | Valor total de la nota |
| nombreTransportador | Sí | Transportista - Nombre corporativo | |
| cnpjTransportadora | Sí | 99.999.999/9999-99 | Transportista - CNPJ |
| direcciónTransportador | No | Transportista - Dirección | |
| numberEndTransportadora | No | Transportista - Número de dirección | |
| barrioTransportadora | No | Empresa de transporte - Barrio | |
| ciudadTransportador | No | Transportista - Ciudad | |
| ufTransportadora | No | Transportista - Estado | |
| cepTransportadora | No | 99999999 | Transportista - CEP |
| registroEstadoTransportadora | No | Transportista - Registro estatal | |
| CIFFOB | Sí | Transportista - Método de Transporte a Cuenta: (1) Contratación de Transporte por cuenta del Remitente (CIF), (2) Contratación de Transporte por cuenta del Destinatario (FOB), (4) Contratación de Transporte por cuenta de Terceros, (5) Contratación Flete por cuenta de Terceros, (5) No ocurrencia de transporte, (6) Transporte propio por cuenta del Remitente y (7) Transporte propio por cuenta del Destinatario | |
| VEHÍCULO | No | Transportista - Matrícula del vehículo | |
| ufVehículo | No | Transportista - Estado | |
| CANTIDAD | No | 999999999999 | Transportista - Cantidad |
| ESPECIES | No | Portador - Especies | |
| MARCA | No | Transportista - Marca | |
| NÚMERO | No | Transportista - Número | |
| PESO NETO | Sí | 999999999999 | Portador - Peso neto (gramos) |
| PIS (Programa de Integración Social) | Sí | 000000000.00 | PIS (Programa de Integración Social) |
| COFINES | No | 000000000.00 | COFINES |
| CS | No | 000000000.00 | Centro de costos |
| IR | No | 000000000.00 | Impuesto sobre la Renta |
| VALORES | No | 000000000.00 | Valor del ISS |
| VALORSERVICOS | No | 000000000.00 | Valor del servicio |
| IDMOVIMIENTO | Sí a la devolución | 999999999999 | O número en Entradas/Salidas de Gestión IDRM |
| numArtículos | Sí | 000000000.00 | |
| TIPO | Sí | Solicitud de factura | Indica si el Registro es un Pedido (P) o una Factura (N) |
| fechaColección | No | Fecha estimada de recogida por parte del transportista. Información correspondiente a la Fecha Esperada de Embarque. | |
| coleccióntiempo | No | Tiempo estimado de recogida en el transportista. Información correspondiente a la Fecha Esperada de Embarque. | |
| OBSERVACIÓN | No | Texto libre | Datos adicionales |
| IDENTIFICACIÓN CLAVEEXT | No | Texto libre | Clave de identificación del documento externo |
| ACCESO CLAVE | No | Indica la clave de acceso de NFe. | |
| SECUENCIAPADO | No | Sólo se envía en el archivo de facturación (ANF) si la secuencia de la factura es diferente de la secuencia del pedido. | |
| cnpjTranspRedespacho | No | 99.999.999/9999-99 | Empresa de transporte Redespacho - CNPJ |
| datosImpExp | |||
| registroEstEmitente | No | Emisor - Registro Estatal / Cuando existe un depositante con el mismo CNPJ y más de una IE, entonces la IE se vuelve obligatoria para el sistema. | |
| códigoServicoTransportadora | No | Indica el código de servicio que utilizará el transportista. | |
| CFOP* | Sí | CFOP* | |
| DECROPER | Sí | Descripción de la operación | |
| VALORES DE LIBERACIÓN | No | 000000000.00 | Valor ICMS exento |
| PRESENCIACOMPRADOR | No | 0 - No aplica (por ejemplo, factura complementaria o de ajuste) - (0); 1 - Operación presencial - (1); 2 - Operación no presencial, vía Internet - (2); 3 - Operación no presencial, Teleservicio - (3); 4 - NFC-e en funcionamiento con entrega a domicilio - (4); 5 - Operación presencial fuera del establecimiento - (5); 6- Operaciones no presenciales, otras. - (9) | |
| FORMATO DE PAGO | No | 0 - Dinero - (01); 1 - Cheque - (02); 2 - Tarjeta de Crédito - (03); 3 - Tarjeta de Débito - (04); 4 - Crédito de la tienda - (05); 5 - Vale de alimentación - (10); 6 - Vale de Comida - (11); 7 - Vale regalo - (12); 8 - Bono de Combustible - (13); 9 - Duplicado Comercial - (14); 10 - Sin pago - (90); 11 - Otros. - (99) | |
| PROTOCOLONFO | Sí | Protocolo de factura electrónica. | |
| FECHA DE RECEPCIÓN | Sí | DD/MM/AAAA HH24:MI:SS | Fecha de recepción del Protocolo NFE |
| Campo | Obligatoriedad | Mascarilla | Descripción |
|---|---|---|---|
| CODIGO INTERNO | Sí | 99999999999999999999 | Número de factura |
| NUMPEDIDO | Sí | 99999999999999999999 | Numéro del pedido |
| CNPJDEPOSITOR | Sí | 99.999.999/9999-99 | Depositante del CNPJ |
| CNPJEMITENTE | Sí | 99.999.999/9999-99 | Salida=Depositante CNPJ / Entrada=Proveedor CNPJ |
| secuencia | No | Serie de la factura | |
| TIPO | Sí | Entrada = E / Salida = S | |
| IDSEQ | Sí | 999999999999 | Secuencia de artículos (orden de impresión de los artículos) |
| CODIGOINDUSTRIA | Sí: para obtener más detalles en la columna Descripción | Código Interno de Producto - Depositante (Requerido sólo si el campo DESCRPROD no está completado) | |
| DESCRIPCIÓN DEL PRODUCTO | Sí | Descripción del Producto | |
| barProducto | Sí | Código de barras del producto | |
| CLASIFICACIÓN FISCAL | No | Clasificación fiscal del producto | |
| CALLE | No | Situación Tributaria | |
| valor unitario | Sí | 999999999.99 | Valor unitario |
| valor total | Sí | 999999999.99 | Valor total del artículo |
| tasa ICMS | No | 999,99 | tasa ICMS |
| tasa IPI | No | 999,99 | tasa IPI |
| IPI | No | 999999999.99 | IPI |
| valordescuento | No | 999999999.99 | Monto de descuento por artículo |
| porcentaje de descuento | No | 999,99 | Descuento - % |
| DESCUENTO | No | 999999999.99 | Valor total del descuento |
| TOTAL LÍQUIDO | Sí | 999999999.99 | Valor neto total |
| TIPO DE PRODUCTO | Sí | Producto = P / Servicio = S | |
| NOTA DE IDENTIFICACIÓN TRIBUTARIA | Sí | 999999999999 | Identificador de Nota Fiscal - Corporativa g-com |
| númeroSerie | No | Para lanzar un producto con un número de serie específico, se debe informar el número. | |
| TIPO DE MATERIAL | No | 999999999999 | Identifica el tipo de producto: Lote, activo, etc. |
| ST3 | No | Estado fiscal con 3 dígitos | |
| baseICMSsubst | Numérico | 999,99 | |
| baseSubSt | No | 999,99 | |
| gastoAccesorio | |||
| aliqIcmsSt | |||
| reducciónIcms | |||
| claseIpi | |||
| códigoSeloIpi | |||
| cantidadSeloIpi | |||
| códigoIpi | |||
| cstIpi | |||
| bcIpi | |||
| valorBcIi | |||
| valorAduanasDesp | |||
| valorIi | |||
| valorIiOperFinanzas | |||
| cstPis | |||
| bcPis | |||
| aliqpis | |||
| cstCofins | |||
| bcCofins | |||
| aliqCofins | |||
| baseIcms | |||
| valorIcms | |||
| flete | |||
| seguro | |||
| orinar | |||
| ataúdes | |||
| cfop | |||
| inscStateIssuer | No | Emisor - Registro Estatal / Cuando existe un depositante con el mismo CNPJ y más de una IE, entonces la IE pasa a ser obligatoria para el sistema. | |
| descrReducido | |||
| CANTIDAD SERVIDA | Si Regresar | 999999999999 | Cantidad cumplimentada para este artículo Si hay un corte, el valor devuelto será CERO |
| valorIcmsAliviado | No | 000000000.00 | Valor ICMS exento |
| CÓDIGO PRODANVISA | No | Código de producto ANVISA | |
| PRECOMAXIMOCONSUMIDOR | No | 9999999999.99 | Precio máximo al consumidor |
| MOTIVO EXENCIÓN | No | Motivo de la exención de ANVISA. Para medicamentos exentos de registro en ANVISA, se debe proporcionar el número de la decisión que los exime. | |
| icmsSubst |
Retorno
{ "headers": { }, "body": { "message": "Integración programada correctamente.", "protocol": "9394" }, "statusCode": "CREADO", "statusCodeValue": 201 }
{ "headers": { }, "body": { "message": "ApiKey no encontró la configuración de integración, operación cancelada". }, "statusCode": "NO AUTORIZADO", "statusCodeValue": 401 }
{ "headers": { }, "body": { "message": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Ejemplos
{ "codeInterno" : "140620", "numPedido" : "PED-140620", "cnpjDepositante" : "18.931.662/0001-40", "cnpjEmitente" : "18.931.662/0001-40", "sequence" : "1", "tipo" : "S", "status" : "A", "o" : "W", "motivoCancellamento" : null, "c" : "N", "idNotaFiscal" : 4450, " nPalet" : null, "seqEntrega" : null, "paginaGeoMapa" : "0000000000", "descrRomaneio" : "ERP FACTURACIÓN - OTROS CON INF. ESPECIFICAR ", "placa" : null, "motorista" : null, "cnpjMotorista" : null, "dataEmissao" : "06/06/2023", "qtyVolume": "1", "totalPesoVolume": "106", " cnpjDest" : "28.653.333/0001-39", "identificadorPedido" : null, "totalCubagemVolume" : "1000024", "codigoTipoPedido" : null, "tipoEnvio" : "0", "especieVolume" : null, "dataFaturamento" : "14/06/2023 10:45:14", "dataFaturamentoSegMomento" : "14/06/2023 10:45:14", "items" : [ { "sequencia" : "1", "idSeq" : " 2", "bar" : "2000000137001", "cantidad" : 3, "quantidadeAtendida" : 3, "quantidadeCorteFisico" : 0, "codigoProduto" : "17003", "lot" : null, "barraEmb" : "2000000137001" , "vlrUnit" : 166.6666666667, "pesoBruto" : 0.006, "vencimiento" : null, "fabricacao" : null, "palletCaixaColetiva" : null, "numeroCaixaColetiva" : null, "serieCaixaColetiva" : null, "descCaixaSeparacao" : null, " identifierPedido" : null, "volume" : "1", "barraVolume" : 98100045870001, "nfEntrada" : 0, "serieNfEntrada" : null, "cnpjEmitenteEntrada" : null, "idNfDet" : 5892, "tipoEnvio" : "No" , "infEspeca" : [ { "idFaturamentoEspec" : 10, "informacaoEspeca" : "SERIE", "valor" : "100008" } ] } ] }
Endpoint para la integración de órdenes, sigue las mismas reglas de integración banco a banco (INT_PEDIDO) y (INT_PEDIDODET), pero utilizando la estructura JSON.
Método: Publicar
URL: /webresources/rest/v2/pedido/integrar
Encabezados:
- Tipo de contenido: aplicación/JSON
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Envío
{ "numPedido": "", "sequencia": "", "cnpjDepositante": "", "codigoInterno": "", "cnpjEmitente": "", "tipo": null, "descrOper": "", " cfop": "", "dateIssuance": "", "personRecipient": "", "código de destinatario": "", "nombre del destinatario": "", "fantasiaRecipient": "", "cnpjRecipient": "", " destinatarioaddress ": "", "recipientEndnumber": "", "recipientEndcomplement": "", "recipientneighborhood": "", "recipientzip": "", "recipientcity": "", "recipientphone": "", "telephone2 " : "", "ufDestinatario": "", "inscricaoEstadualDestinatario": "", "inscricaoMunicipalDestinatario": "", "direcciónEntrega": "", "ciudadEntrega": "", "barrioEntrega": "", "ufEntrega" : "", "cepEntrega": "", "cnpjEntrega": "", "inscricaoEstadualEntrega": "", "baseIcms": 0, "valorIcms": 0, "baseSubstituicao": 0, "valorSubstituicao": 0, " fletes": 0, "seguros": 0, "gastosaccesorios": 0, "ipi": 0, "valorProdutos": 0, "valorTotal": 0, "nomeTransportadora": "", "cnpjTransportadora": "", " direcciónTransportadora ": "", "numeroEndTransportadora": "", "neighborhoodTransportadora": "", "cidadeTransportadora": "", "ufTransportadora": "", "cepTransportadora": "", "inscricaoEstadualTransportadora": "", "cifFob " : "", "vehículo": "", "ufVehículo": "", "cantidad": 0, "especie": "", "marca": "", "número": "", "peso neto": 0 , "pis": 0, "cofins": 0, "cs": 0, "ir": 0, "valorIss": 0, "valorServicos": 0, "geraFinanceiro": "", "tipoDocumento": " " , "tipoCarga": "", "limiteCorte": 0, "paginaGeomapa": "", "numItems": 0, "tipoNf": "", "state": "", "dataCollection": "", " dateAgendamento ": "", "timeCollection": "", "personDelivery": "", "codeDelivery": "", "nameDelivery": "", "fantasyDelivery": "", "numeroEndEntrega": "", "complementoEndDelivery " : "", "nameRepresentative": "", "phoneRepresentative": "", "cnpjUnit": "", "invoice": "", "observation": "", "estoqueVerificado": "", "chaveIdentificacaoExt" : "", "classificacaoCliente": 0, "prioridade": "", "percentagemCxFchada": 0, "chaveAcessoNFE": "", "cnpjTranspRedespacho": "", "enderecoConsig": "", "cidadeConsig": "" , "bairroConsig": "", "ufConsig": "", "cepConsig": "", "inscricaoEstConsig": "", "pessoaConsig": "", "codigoConsig": "", "razaoSocialConsig": "", "fantasyConsig": "", "numeroEndConsig": "", "complementoEndConsig": "", "inscricaoEstEmitente": "", "codigoServicoTransportadora": "", "pickToLight": "", "roteiro": "", " codigoTipoPedido ": "", "embarquePrioritario": "", "tipoRegimeTtribuacao": "", "seqEntrega": 0, "razaoSocialEmitente": "", "fantasiaEmitente": "", "codeRetencao": "", "valorIcmsExonerado" : 0, "Purchaserpresence": "", "PaymentForm": "", "EntryType": "", "Separationbar": "", "Receiptweek": "", "Receiptyear": "", "Availabilityweek": " " , "anoAvailizacao": "", "utilizaZPL": "", "codigoRastreio": "", "agrupadorPed": 0, "idOrdemTransSaida": 0, "codigoPaisDestinatario": "", "codigoServicoEtiquetaExterna": "", " observacaoSeparacao ": "", "inscricaoEstadualDepositante": "", "idIntegracaoErp": "", "dataPagto": "", "numeroOrdemProducao": "", "idMovimento": "", "idNotaFiscal": 0, "cnpjConsig" : "", "intCubometro": "", "dataPlanejamento": "", "invoicingDoisMomentos": "", "dataBilling": "", "canalVenda": "", "janelaInicio": "", "janelaFim": " ", "codigoTipoRecebimento": "", "protocoloNfe": "", "dataRecebimentoNfe": "", "personalizacaoItem": [ { "chave": "", "valor": "" } ], "items": [ { "codeInternal": "", "numPedido": "", "cnpjDepositante": "", "cnpjEmitente": "", "sequencia": "", "tipo": "", "idSeq": "" , "codigoIndustria": "", "descricaoProduto": "", "barraProduto": "", "classificacaoFiscal": "", "st": "", "quantidade": "", "valorUnitario": "", " valorTotal": "", "aliquotaICMS": "", "aliquotaIPI": "", "ipi": "", "valorDesconto": "", "percentualDesconto": "", "descuento": "", " totalNet ": "", "tipoProduto": "", "quantidadeAtendida": "", "idNotaFiscal": "", "numeroSerie": "", "tipoMaterial": "", "st3": "", "inscricaoEstEminte " : "", "dateExpirationLote": "", "descricaoRedutora": "", "idItemERP": "", "valorICMSdeonerado": "", "codigoProdutoAnvisa": "", "precoMaximoConsumidor": "", "baseICMS" : "", "valorICMS": "", "importacaoCobFiscal": "", "aliquotaPIS": "", "basePIS": "", "valorPIS": "", "aliquotaConfins": "", "baseConfins": " ", "valorConfins": "", "origemProduto": "", "remesa": "", "notaFiscal": "", "serieNF": "", "tipoPTL": "", "tipoCaixaSep": " " , "volumeCaixa": "", "indDeduzDeson": 0, "motivoDesoneracaoICMS": 0, "messagemCaixa": "", "codigoSetor": "", "motivoIsencao": "", "numeroOrdemCompra": "", " obsItemSeparacao ": "", "itensConferenciaEspecica": [ { "numeroNf": "", "serieNf": "", "batch": "", "fecha de validez": "", "Datos de fabricación": "", " codigoProduto": "", "cantidad": 0, "idSeq": 0, "idSeqCfe": 0 } ] } ] }
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| NUMPEDIDO | Sí | Si es FACTURA, un campo NUMÉRICO, si es un PEDIDO, un campo Alfanumérico | Numéro del pedido |
| SECUENCIA | No | Serie de la factura | |
| CNPJDEPOSITOR | Sí | 99.999.999/9999-99 | Depositante del CNPJ |
| CODIGO INTERNO | Sí | 99999999999999999999 | Número de factura |
| CNPJEMITENTE | Sí | 99.999.999/9999-99 | Salida=Depositante CNPJ / Entrada=Proveedor CNPJ |
| TIPO | Sí | Entrada = E / Salida = S | |
| DECROPER | Sí | Descripción de la operación | |
| CFOP* | Sí | CFOP (Código Fiscal de Operación) | |
| FECHA DE EMISIÓN | Sí | DD/MM/AAAA | Fecha de la factura de impuestos |
| personaDestinatario | Sí | Destinatario - Física = F / Legal = J | |
| código de destinatario | Sí | Código del Destinatario | |
| nombreDestinatario | Sí | Destinatario - Nombre Corporativo | |
| fantasíaDestinatario | No | Destinatario - Nombre comercial | |
| cnpjDestinatario | Sí | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Destinatario - CNPJ para PJ / CPF para PF |
| direcciónDestinatario | Sí | Dirección del receptor | |
| númeroEndRecipient | No | Destinatario - Número de dirección | |
| complementoEndRecipient | No | Destinatario - Complemento, Si este campo tiene más de 50 caracteres déjelo vacío y use el campo COMPLEMENTO_DEST | |
| barrioDestinatario | Sí | Destinatario - Barrio | |
| CEPDestinatario | Sí | 99999999 | Destinatario - Código Postal |
| ciudadDestinatario | Sí | Destinatario - Ciudad | |
| teléfonoDestinatario | No | Destinatario - Teléfono | |
| TELÉFONO2 | No | Destinatario - Número de teléfono adicional | |
| FECHA DE PROGRAMACION | No | DD/MM/AAAA HH:MM:SS | Indica la fecha programada por el destinatario para la entrega del pedido/factura (Usado por RMS Senior) |
| ufDestinatario | Sí | Destinatario - Estado | |
| registroEstadoDestinatario | No | Destinatario - Registro estatal | |
| registroMunicipalDestinatario | No | Destinatario - Registro Municipal | |
| direcciónEntrega | Sí, si los detalles de entrega están disponibles | Dirección de entrega | |
| ciudadEntrega | Sí, si los detalles de entrega están disponibles | Entrega - Ciudad | |
| barrioEntrega | Sí, si los detalles de entrega están disponibles | Entrega - Barrio | |
| ufEntrega | Sí, si los detalles de entrega están disponibles | Estado de envio | |
| cepEntrega | Sí, si los detalles de entrega están disponibles | 99999999 | Entrega - CEP |
| cnpjEntrega | Sí, si los detalles de entrega están disponibles | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Entrega - CNPJ o CPF |
| registroEstadoEntrega | No | Entrega - Registro estatal | |
| baseIcms | No | 000000000.00 | Base de cálculo del ICMS |
| VALORICOS | No | 000000000.00 | Valor IVA |
| REEMPLAZO DE BASES | No | 000000000.00 | Base de cálculo de reemplazo de ICMS |
| VALORES DE REEMPLAZO | No | 000000000.00 | Valor de reemplazo del ICMS |
| FLETE | No | 000000000.00 | Valor del Flete |
| SEGURO | No | 000000000.00 | Valor del seguro |
| GASTOS DE ACCESORIOS | No | 000000000.00 | Otros gastos accesorios |
| IPI | No | 000000000.00 | Valor total del IPI |
| valorProductos | Sí | 000000000.00 | Valor total de los productos |
| valor total | Sí | 000000000.00 | Valor total de la nota |
| nombreTransportador | Sí | Transportista - Nombre corporativo | |
| cnpjTransportadora | Sí | 99.999.999/9999-99 | Transportista - CNPJ |
| direcciónTransportador | No | Transportista - Dirección | |
| numberEndTransportadora | No | Transportista - Número de dirección | |
| barrioTransportadora | No | Transportista - Barrio | |
| ciudadTransportador | No | Transportista - Ciudad | |
| ufTransportadora | No | Transportista - Estado | |
| cepTransportadora | No | 99999999 | Transportista - CEP |
| registroEstadoTransportadora | No | Transportista - Registro estatal | |
| CIFFOB | Sí | Transportista - Método de Transporte a Cuenta: (1) Contratación de Transporte por cuenta del Remitente (CIF), (2) Contratación de Transporte por cuenta del Destinatario (FOB), (4) Contratación de Transporte por cuenta de Terceros, (5) Contratación Flete por cuenta de Terceros, (5) No ocurrencia de transporte, (6) Transporte propio por cuenta del Remitente y (7) Transporte propio por cuenta del Destinatario | |
| VEHÍCULO | No | Transportista - Matrícula del vehículo | |
| ufVehículo | No | Transportista - Estado | |
| CANTIDAD | No | 999999999999 | Transportista - Cantidad |
| ESPECIES | No | Portador - Especie | |
| MARCA | No | Transportista - Marca | |
| NÚMERO | No | Transportista - Número | |
| PESO NETO | Sí | 999999999999 | Portador - Peso neto (gramos) |
| PIS (Programa de Integración Social) | No | 000000000.00 | PIS (Programa de Integración Social) |
| COFINES | No | 000000000.00 | COFINES |
| CS | No | 000000000.00 | Centro de costos |
| IR | No | 000000000.00 | Impuesto sobre la Renta |
| VALORES | No | 000000000.00 | Valor del ISS |
| VALORSERVICOS | No | 000000000.00 | Valor del servicio |
| GERAFINCEIRO | Sí | Sí No | Ir a Ajuste de Carga o No |
| TIPO DE DOCUMENTO | Sí | Tipo de Documento | Tipo de Documento de Facturación - Efectivo = D / Cheque = C / Comprobante = B / X = Bono / Otros = T |
| TIPO DE CARGA | Sí | Tipo de carga: refrigerada, seca, productos especiales | |
| LÍMITE | No | 000000000.00 | Valor mínimo para cancelar el pedido. |
| MAPA DE PÁGINA | No | 999999999999 | Mapa geográfico o página de sector |
| NÚMITES | Sí | 000000000.00 | Número de productos diferentes en el pedido/nota |
| TIPO | Sí | Solicitud de factura | Indica si el Registro es un Pedido (P) o una Factura (N) |
| ESTADO | Sí | Indica el estado del Pedido/Factura (N) Bien, (D) Dañado, (T) Truncado o Caducado. | |
| RECOPILACIÓN DE DATOS | No | DD/MM/AAAA | Fecha estimada de recogida por parte del transportista. Información correspondiente a la Fecha Esperada de Embarque. |
| HORACOLETA | No | HH24:MM:SS | Tiempo estimado de recogida en el transportista. Información correspondiente a la Fecha Esperada de Embarque. |
| REPARTIDOR | No | F/J | Entidad de entrega - Física = F / Legal = J |
| CÓDIGO DE ENTREGA | No | Código de entidad de entrega | |
| NOMBRE DE ENTREGA | No | Entidad Entregadora - Nombre Corporativo | |
| ENTREGA FANTASIA | No | Entidad de entrega - Nombre comercial | |
| ENTRADA DE NUMEROS | No | Entidad de entrega - Número de dirección | |
| ENTREGA FINAL DEL COMPLEMENTO | No | Entidad de entrega: complemento | |
| NOMBRE REPRESENTATIVO | No | Nombre del representante de ventas | |
| REPRESENTANTE TELEFÓNICO | No | Número de teléfono del representante de ventas | |
| CNPJUNIDADE | Sí | 99.999.999/9999-99 | Unidad de almacenamiento CNPJ |
| FACTURA | No | Texto libre | Condiciones de pago |
| OBSERVACIÓN | No | Texto libre | Datos adicionales |
| STOCK COMPROBADO | No | S/N/B | Indica si la factura comprobará stock o no. "N" = No liberado / "B" = Bloqueado / "S" = Liberado |
| IDENTIFICACIÓN CLAVEEXT | No | Texto libre | Clave de identificación del documento externo |
| CLASIFICACIÓN DE CLIENTES | No | 999999999999 | Indica la clasificación del Cliente para la prioridad de lanzamiento. |
| PRIORIDAD | No | Indica la prioridad del valor del pedido. P, M, L | |
| PORCENTAJEMCXCERRADO | No | 000000000.00 | Indica el porcentaje de caja cerrada para prioridad de liberación. |
| ACCESO CLAVE | No | Indica la clave de acceso de NFe. | |
| CNPJTRANSPREDESPACHO | No | 99.999.999/9999-99 | Empresa de transporte Redespacho - CNPJ |
| DIRECCIÓNCONSIG | No | Dirección del consignatario | |
| CIDADECONSIG | No | 14400000 | Destinatario - Ciudad |
| BAIRROCONSIG | No | Destinatario - Vecindario | |
| UFCONSIG | No | UF | Destinatario - Estado |
| CEPCONSIG | No | 14400000 | Destinatario - CEP |
| INSCRESTADUALCONSIG | No | Destinatario - Registro estatal | |
| PESSOACONSIG | No | j | Entidad consignataria - Física = F / Legal = J |
| CODECONSIG | No | Entidad Destinataria - Código | |
| razónSocialConsig | Razón social del consignador | ||
| FANTASIACONSIG | No | Entidad consignataria - Nombre comercial | |
| numeroEndConsig | No | Entidad consignataria - Número de dirección | |
| COMPLEMENTOENDCONSIG | No | Entidad Destinataria - Complemento | |
| INSCRESTADUALEMITENTE | No | Emisor - Registro Estatal / Cuando existe un depositante con el mismo CNPJ y más de una IE, entonces la IE se vuelve obligatoria para el sistema. | |
| códigoServicoTransportadora | No | Indica el código de servicio que utilizará el transportista. | |
| PICKTOLIGHT | No | 0 | Indica si la factura utilizará el proceso de separación vía pick to light (PTL) - 1 = Sí / 0 = No |
| MAPA VIAL | No | Indica el número de la ruta de entrega de la factura. | |
| CÓDIGOTIPOORDEN | No | Indica el código de integración del tipo de orden. | |
| PRIORIDAD DE EMBARQUE | No | Indica si la Factura tiene embarque prioritario (vía rápida) 0-No 1-Sí | |
| TIPOREGIMETATRIBUCIÓN | No | Régimen Tributario - Predeterminado 0 | |
| ENTREGA SECUNDARIA | No | Indica la secuencia de entrega. | |
| motivoSocialIssuer | Razón social del emisor | ||
| fantasíaEmisor | No | Razón social del emisor de la factura | |
| códigoRetención | No | Código de motivo interno (utilizado por ERP) | |
| VALORES DE LIBERACIÓN | No | 000000000.00 | Valor Icms Exentos |
| PRESENCIACOMPRADOR | No | 0 - No aplica (por ejemplo, factura complementaria o de ajuste) - (0); 1 - Operación presencial - (1); 2 - Operación no presencial, vía Internet - (2); 3 - Operación no presencial, Teleservicio - (3); 4 - NFC-e en funcionamiento con entrega a domicilio - (4); 5 - Operación presencial, fuera del establecimiento - (5); 6 - Operaciones no presenciales, otras. - (9) | |
| FORMATO DE PAGO | No | Método de pago: 0 - Efectivo - (01); 1 - Cheque - (02); 2 - Tarjeta de Crédito - (03); 3 - Tarjeta de Débito - (04); 4 - Crédito de la tienda - (05); 5 - Vale de alimentación - (10); 6 - Vale de Comida - (11); 7 - Vale regalo - (12); 8 - Bono de Combustible - (13); 9 - Duplicado Comercial - (14); 10 - Sin pago - (90); 11 - Otros. - (99); 12 - Recibo bancario - (15) | |
| TIPO DE ENTRADA | No | Tipo de entrada de documento: 0 - Factura; 1 - Transferencia | |
| SEPARACIÓN DE BARRAS | No | Identifica el pedido o factura con un valor único | |
| RECIBO SEMANAL | No | semana de recibo | |
| RECIBO | No | 2022 | Año de recibo |
| DISPONIBILIDAD SEMANAL | No | Semana de disponibilidad | |
| DISPONIBILIDAD | No | 2022 | Año de disponibilidad |
| utilizarZPL | |||
| SEGUIMIENTO DE CÓDIGOS | No | Código de seguimiento para el volumen donde se encuentran los elementos de la nota | |
| AGRUPADO | No | 999999999999 | Número de envíos existentes para el pedido (agrupador) en el ERP (se utiliza cuando el pedido o nota WMS representa varias notas en el ERP) |
| idOrdemTransSaida | |||
| códigoPaisDestinatario | No | Código de país para destinatario/entrega extranjero | |
| codeServiceEtiqueta externa | No | Código de integración con servicio de etiquetas externo. Cuando se utiliza ZPL | |
| observaciónSeparación | No | Nota dejada por el cliente en su pedido. Ej: solicito poner el nombre debajo del número | |
| registroEstadoDepositante | No | Registro estatal del depositante. | |
| IDINTEGRACAOERP | No | Identificador único en el proceso de integración con Senior ERP | |
| PROTOCOLONFO | No | Protocolo de Factura Electrónica | |
| FECHA DE RECEPCIÓN | No | DD/MM/AAAA HH24:MI:SS | Fecha de recepción del Protocolo NFE |
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| I | Sí | 4 | Valor Fijo |
| CODIGO INTERNO | Sí | 99999999999999999999 | Número de factura |
| NUMPEDIDO | Sí | Si es FACTURA, campo NUMÉRICO, si es PEDIDO, campo ALFANUMÉRICO | Numéro del pedido |
| CNPJ_DEPOSITANTE | Sí | 99.999.999/9999-99 | Depositante del CNPJ |
| CNPJ_ISSUER | Sí | 99.999.999/9999-99 | Salida=Depositante CNPJ / Entrada=Proveedor CNPJ |
| SERIE | No | Serie de la factura | |
| TIPO | Sí | Entrada = E / Salida = S | |
| IDSEQ | Sí | 999999999999 | Secuencia de artículos (orden de impresión de los artículos) |
| CODIGOINDUSTRIA | Sí - (solo si DESCRPROD no está completado) | Código Interno de Producto - Depositante | |
| DESCR_PROD | Sí | Descripción del Producto | |
| BAR | Sí | Código de barras del producto | |
| CLASIFICACIÓN FISCAL | No | Clasificación fiscal del producto | |
| CALLE | No | Situación Tributaria | |
| CANTIDAD | Sí | 999999999999 | Cantidad |
| VLRUNIT | Sí | 999999999.99 | Valor unitario |
| VLRTOTAL | Sí | 999999999.99 | Valor total del artículo |
| ALIQICMS | No | 999,99 | tasa ICMS |
| ALIQIPI | No | 999,99 | tasa IPI |
| IPI | No | 999999999.99 | IPI |
| VLRDESC | No | 999999999.99 | Valor de descuento por artículo |
| BYCDESCUENTO | No | 999,99 | Descuento - % |
| DESCUENTO | No | 999999999.99 | Valor total del descuento |
| TOTAL LÍQUIDO | Sí | 999999999.99 | Valor neto total |
| TIPO DE PRODUCTO | Sí | Producto = P / Servicio = S | |
| CANTIDAD SERVIDA | Sí Regresar | 999999999999 | Cantidad cumplimentada para este artículo Si hay un corte, el valor devuelto será CERO |
| NOTA DE IDENTIFICACIÓN TRIBUTARIA | Sí | 999999999999 | Identificador de Nota Fiscal - Corporativa g-com |
| SERIE DE NÚMEROS | No | Para enviar un producto con un número de serie específico, se debe proporcionar el número. | |
| TIPO DE MATERIAL | No | 999999999999 | Identifica el tipo de producto: Lote, activo, etc. |
| ST_2 | No | Estado fiscal con 3 dígitos | |
| IDENTIFICACIÓN CLAVEEXT | No | Clave de identificación externa | |
| SECUENCIAPADO | No | Secuencia de pedido para localizarlo en facturación | |
| CODINDUSTRIA | Sí | Código Interno de Producto - Depositante con mayor precisión | |
| DESCRPROD | Sí | Descripción del producto con mayor precisión | |
| INSCRESTADUAL_EMIT | No | Emisor - Registro Estatal / Cuando hay un depositante con el mismo CNPJ y más de una IE, entonces la IE se vuelve obligatoria para el sistema. | |
| INCREÍBLE | Sí: para obtener más detalles en la columna Descripción | Sí ¿ (solo si el depositante está configurado para importar el producto validando la breve descripción) Sigla resumen en el empaque. Ej: CX, ONU, DP | |
| VALORES DE LIBERACIÓN | No | 000000000.00 | Valor IVA desonerado |
| CÓDIGO PRODANVISA | No | Código de producto ANVISA | |
| PRECOMMAXIMOCONSUMIDOR | No | 9999999999.99 | Precio máximo al consumidor |
| MOTIVO EXENCIÓN | No | Motivo de la exención de ANVISA. Para medicamentos exentos de registro en ANVISA, se debe proporcionar el número de la decisión que los exime. | |
| KIT DE CÓDIGOS | No | Indica el código del kit al que pertenece el artículo. | |
| IDITEMERP | No | Identificador de elemento del documento enviado por el ERP | |
| SEPARACIÓN DE NOTAS | No | Nota dejada por el cliente en su pedido específico para cada artículo. Ej: Nombre: Cliente, Número: 10 | |
| CODSETOR | No | Código de depósito informado por ERP | |
| REGALO | No | Inicia el canal de venta de pedidos (solo para información) | |
| BUZON DE MENSAJE | No | Indica al sistema PTL qué mensaje se debe imprimir al destinatario en casos de mensajes de regalo, por ejemplo | |
| NOTA FISCAL | No | Número de factura al que pertenece el artículo en el ERP (se utiliza cuando el pedido o nota WMS representa varias notas en el ERP) | |
| ENVÍO | No | Número de entrega al que pertenece el artículo en el ERP (se utiliza cuando el pedido o nota WMS representa varias notas en el ERP) | |
| SERIE | No | Número de serie de la factura a la que pertenece el artículo en el ERP (se utiliza cuando el pedido o factura WMS representa varias facturas en el ERP) | |
| TIPO CAJAESEP | No | Indica al sistema PTL qué tipo de caja de separación se debe utilizar para generar el volumen por el mismo | |
| TIPOPTTL | No | Indica la línea PTL donde se debe recoger el artículo cuando el pedido o nota está marcado como PTL. Representa el código PTL de la región de almacenamiento. | |
| VOLUMEN DE LA CAJA | No | Indica al sistema PTL qué número de volumen se debe utilizar para su generación, indicando que los materiales deben aislarse en un volumen determinado | |
| INDDEDUZDESON | No | El campo solo se puede completar con (0) No deduce y (1) Deduce el valor ICMS deducido (vICMSDeson) del valor del artículo (vProd)/total NF-e (indDeduzDeson) | |
| MOTIVO DE LA PUBLICACIÓN DEL ICMS | No | El campo Motivo de exención de ICMS indica el motivo para deducir el monto de ICMS exento. |
Retorno
{
"encabezados": {
},
"cuerpo": {
"message": "Integración programada exitosamente.",
"protocolo": "9394"
},
"statusCode": "CREADO",
"valorCódigoEstado": 201
}
{
"encabezados": {
},
"cuerpo": {
"message": "ApiKey no encontró la configuración de integración, operación cancelada."
},
"statusCode": "NO AUTORIZADO",
"valorCódigoEstado": 401
}
{
"encabezados": {
},
"cuerpo": {
"mensaje": "java.lang.NullPointerException"
},
"statusCode": "INTERNAL_SERVER_ERROR",
"valorCódigoEstado": 500
}
Ejemplos
{ "numPedido": "2702230", "sequencia": "1", "cnpjDepositante": "44.444.444/4444-44", "codigoInterno": "2702230", "cnpjEmitente": "44.444.444/4444- 44", "type": "S", "descrOper": "VENTA DE BIENES ADQUIRIDOS O RECIBIDOS DE TERCEROS", "cfop": "5102", "dateIssuance": "24/02/2023", "persona receptora ": "J", "código del destinatario": "1", "nombre del destinatario": "sin nombre", "disfraz del destinatario": "NF-E EMITIDA EN UN ENTORNO DE APROBACIÓN - SIN VALOR", "cnpjRecipient": "11.111 .111/1111- 11", "direcciónDestinatario": "PROFESSORA EDUL RANGEL RABELLO", "numeroEndDestinatario": "1300", "complementoEndDestinatario": "", "barrioDestinatario": "RESIDENCIAL JEQUITIBÁ", "cepDestinatario": "14098331" , "cidadeDestinatario": "RIBEIRÃO PRETO" RANGEL RABELLO", "cidadeEntrega": "RIBEIRÃO PRETO", "barrioEntrega": "RESIDENCIAL JEQUITIBÁ", "ufEntrega": "SP", "cepEntrega": "14098331", "cnpjEntrega" : "11.111.111/1111-11 ", "inscricaoEstadualEntrega": " ", "baseIcms": 0.0, "valorIcms": 0.0, "baseSubstituicao": 0.0, "valorSubstituicao": 0.0, "flete": 0.0, "seguros ": 0.0, "gastosAccesorios": 0 , "ipi": 0.0, "valorProdutos": 20.0, "valorTotal": 20.0, "nomeTransportadora": "TRANSPORTADORA", "cnpjTransportadora": "33.333.333/3333-33", "addressTransportadora": "", "numeroEndTransportadora": "", "neighborhoodTransportadora": "", "cidadeTransportadora": "", "ufTransportadora": "", "cepTransportadora": "", "inscricaoEstadualTransportadora": "", " cifFob": "1", "vehículo": "DFSD", "ufVeiculo": " ", "qty": 0, "specie": null, "brand": null, "number": null, "pesoLiquido": 1.0, "pis": 0.0, " cofins": 0.0, "cs": 0, "ir": 0, "valorIss": 0.0, "valorServicos": 0.0, "geraFinanceiro": "S", "tipoDocumento": "T", "tipoCarga": "LOAD", "limiteCorte": null, "paginaGeomapa": null, "numItems": 1, "tipoNf": "P", "state": "N", "dataCollection": null, "dataAgendamento": "31/12/1900", "horaCollection": null, "personDelivery": "J", "codeDelivery": null, "nomeEntrega": "ARMAZEM", "fantasiaEntrega": "ARMAZEM", "numeroEndEntrega": "", "complementEndDelivery ": "", "nameRepresentative": null, "telefoneRepresentante": null, "cnpjUnidade": "11.111.111/1111-11", "invoice": null, "observacao": null, "estoqueVerificado": null, " keyIdentificacaoExt": null, "classificacaoCliente": null, "prioridade": null, "percentagemCxFechada": null, "chaveAcessoNFE": " ", "cnpjTranspRedespacho": null, "enderecoConsig": null , "cidadeConsig": nulo, "bairroConsig": nulo, "ufConsig": nulo, "cepConsig": nulo, "inscricaoEstConsig": nulo, "pessoaConsig": nulo, "codigoConsig": nulo, "razaoSocialConsig": nulo, " fantasiaConsig": null, "numeroEndConsig": null, "complementoEndConsig": null, "inscricaoEstEmitente": null, "codigoServicoTransportadora": null, "pickToLight": "N", "roteiro": null, "codigoTipoPedido": "TESTE" , "embarquePrioritario": null, "tipoRegimeTributacao": null, "seqEntrega": null, "razaoSocialEmitente": null, "fantasiaEmitente": null, "codigoRetencao": null, "valorIcmsExonerado": 0, "presencaComprador": null, " formaPagamento": null, "tipoEntrada": null, "barraSeparacao": null, "semanaRecebibilizacao": "", "anoRecebimento": null, "semanaAvailizacao": null, "anoAvailizacao": null, "utilizaZPL": "N", "codigoRastreio": null, "agrupadorPed" " dataPagto": null, "numeroOrdemProducao": null, "idMovimento": null, "idNotaFiscal": null, "cnpjConsig": null, "intCubometro": null, "dataPlanejamento": null , "faturamentoDoisMomentos": null, "dataFaturamento" : null, "canalVenda": null, "janelaInicio": null, "janelaEnd": null, "personalizacaoCab": null, "protocoloNfe": "teste", "dataRecebimentoNfe": " 27/02/2023", "items" : [ { "codeInterno": "2702230", "numPedido": "2702230", "cnpjDepositante": "44.444.444/4444-44", "cnpjEmitente": "44.444. 444/4444-44", "sequencia" : "1", "tipo": "S", "idSeq": 1, "codigoIndustria": "PRD002", "descricaoProduto": "PRD002", "barraProduto": " 2000000001101", "clasificacaoFiscal": null, " st": null, "cantidad": 2.0, "valorUnitario": 10.0, "valorTotal": 20.0, "aliquotaICMS": 12.0, "aliquotaIPI": 0.0, "ipi": 0.0 , "valorDesconto": 0.0, "percentualDesconto" : 0.0, "descuento": null, "totalLiquid": 20.0, "tipoProduto": "P", "quantidadeAtendida": null, "idNotaFiscal": null, "numeroSerie": null , "tipoMaterial": null, "st3" : null, "inscricaoEstEmitente": null, "dataVencimentoLote": null, "descricaoRedutora": "KG", "idItemERP": null, "valorICMSdesonerado": null, "codigoProdutoAnvisa": null , "precoMaximoConsumidor": null, "baseICMS": null, "valorICMS": null, "importacaoCobFiscal": null, "aliquotaPIS": null, "basePIS": null, "valorPIS": null, "aliquotaConfins": null, " baseConfins": nulo, "valorConfins": nulo, "origemProduto": nulo, "remessa": nulo, "notaFiscal": nulo, "serieNF": nulo, "tipoPTL": nulo, "tipoCaixaSep": nulo, "volumeCaixa" : null, "indDeduzDeson": 0, " motivoDesoneracaoICMS": 0, "mensagemCaixa": null, "codigoSetor": "1", "motivoIsencao": null, "numeroOrdemCompra": null, "obsItemSeparacao": null, "personalizacaoItem" : null, "itensConferenciaEspecifica": null } ] , "codigoTipoRecebimento": null }
Particularidades
si el tipociffob se llena con 3 en la integración del pedido y tiene los datos de la entidad consignataria, el sistema validará si la entidad ya se encuentra registrada en el sistema. Si no está y el depositante está configurado para importar lo que no existe, el sistema lo registrará. Si no está configurado para la situación, el sistema mostrará el mensaje "La entidad del destinatario no se puede importar con CIFFOB distinto de 3" durante la integración.
El punto final para la integración de entidades sigue las mismas reglas que la integración de banco a banco (INT_PRODUTO) y (INT_EMBALAGEM), pero utilizando la estructura JSON.
Método: Publicar
URL: /webresources/rest/v2/produto/integrar/
Encabezados:
- Tipo de contenido: aplicación/JSON
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Envío
[ { "idIntegracaoErp": "", "cgc": "", "codReferencia": "", "codigoInterno": "", "descr": "", "tipoProd": "", "cnpjFamilia": "" , "subFamilia": "", "marca": "", "subMarca": "", "activa": "", "color": "", "fabricado": " ", "estacional": "", "segregated": "", "deadlineValidity": "", "deadlineCommercialization": "", "deadlineCritical": "", "subTipoProd": "", "ncm": "", "internal code": "", " descrProd": "", "codTipoProd": "", "cest": "", "motivoIsencao": "", "codigoProdAnvisa": "", "precoMaximoConsumidor": "", "codigoInmetro": "", " kitExpExplodida ": "", "agruparArmazenagemCmpKit": "", "preCadastro": "", "codigoProdutoAnp": "", "descricaoProdutoAnp": "", "descrVoicePicking": "", "embalagens": [ { "idEmbERP" : "", "codeInterno": "", "bar": "", "descrRedutor": "", "descr": "", "presentación": "", "factorConv": "", "height": " ", "ancho": "", "largo": "", "unidad de venta": "", "unidad de compra": "", "lastre": "", "cantidad de capas": "", "peso bruto": " " , "pesoLiquido": "", "empMax": "", "active": "", "caixaFchada": "", "controlaEtoque": "", "seqEmb": "", "descrRedutor2": "" , "cnpjDepositor": "" } ] } ]
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| CGC* | Sí | 99.999.999/9999-99 | Depositante del CNPJ |
| CODREFERENCIA | No | Código de referencia (código de producto del proveedor) | |
| CODIGO INTERNO | Sí | Código de producto interno | |
| DESCRIPCIÓN | Sí | Descripción del Producto | |
| TIPO DE PRODUCTO | No | Tipo de Producto (LIBRO, Utensilios, Comida...) | |
| FAMILIA CNPJ | Sí | 99.999.999/9999-99 | Familia (Productor CNPJ) |
| SUBFAMILIA | No | Subfamilia de productos | |
| MARCA | No | Producto de marca | |
| SUB MARCA | No | Submarca de producto | |
| ACTIVO | Sí | (Sí No | Producto activo |
| COLOR | No | Color del producto | |
| FABRICADO | No | (Sí No | Producto manufacturado |
| ESTACIONAL | No | (Sí No | Producto de temporada |
| Aislado | No | (Sí No | Producto segregado |
| FECHA DE VENCIMIENTO | Sí | Fecha de vencimiento en días o meses, dependiendo de la configuración del depositante. Incumplimiento en meses. | |
| PLAZO DE COMERCIALIZACIÓN | No | Plazo de comercialización en días o meses, dependiendo de la configuración del depositante. Incumplimiento en meses. | |
| PLAZO CRÍTICO | No | Plazo Crítico en días o meses, dependiendo de la configuración del depositante. Patrón en meses | |
| SUBTIPO DE PRODUCCIÓN | No | Subtipo de producto | |
| NCM | No | Código NCM | |
| CODINTERNO | No | Código de producto interno | |
| DESCRPROD | Sí | Descripción del Producto | |
| CODTYPEPROD | No | Tipo de producto Código interno | |
| CEST | No | Código CEST | |
| CÓDIGO PRODANVISA | No | código de producto anvisa | |
| PRECOMAXIMOCONSUMIDOR | No | 0000000000.00 | Precio máximo al consumidor |
| CODIGOINMETRO | No | Código de producto Inmetro | |
| MOTIVO EXENCIÓN | No | Motivo de la exención de ANVISA. Para medicamentos exentos de registro en ANVISA, se debe proporcionar el número de la decisión que los exime. | |
| KITEXPEXPLODIDA | No | (Sí No | Indica si el material es un kit de envío despiezado. Consulta la tabla. |
| KIT DE ALMACENAMIENTO DE AGRUPACIÓN | No | 0-No, 1-Sí | Determina si los componentes del kit se agruparán durante el almacenamiento. |
| PREINSCRIPCIÓN | No | 0-No, 1-Sí | Registro parcial del producto. |
| CÓDIGOPRODUCTANP | No | Código de producto ANP (Agencia Nacional del Petróleo). | |
| DESCRIPCIÓN DEL PRODUCTO | No | 0-No, 1-Sí | Utilice la codificación de productos del Sistema de Información de Movimiento de Productos - SIMP (http://www.anp.gov.br/simp/index.htm). Ingrese 999999999 si el producto no tiene un código de producto ANP. |
| DESCRSELECCION DE VOZ | No | Indica la descripción del producto que se puede utilizar en Voice Picking |
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| CODIGO INTERNO | Sí | Código Interno de Producto en la Empresa | |
| BAR | Sí | Código de barras del producto | |
| INCREÍBLE | No | Descripción de embalaje reducida: ONU, DP o CX | |
| DESCRIPCIÓN | Sí | Descripción para la identificación del embalaje | |
| PRESENTACIÓN | No | Presentación del empaque - "12 x 200 gr" | |
| CONVFACTOR | Sí | 999 | Factor de Conversión (Número de Unidades por Caja). Este campo tiene un límite de 6 caracteres. |
| ALTURA | (Sí No | 999999999999 | Altura en mm |
| ANCHO | (Sí No | 999999999999 | Ancho en MM |
| LONGITUD | (Sí No | 999999999999 | Longitud en MM |
| VENTA UNIDAD | No | (Sí No | Embalajes más pequeños para Entrada de Mercancías |
| COMPRA UNIDAD | No | (Sí No | Embalaje de mercancías salientes más pequeñas |
| LASTRE | (Sí No | 999999999999 | Unidades totales en una capa de paleta |
| CANTIDAD CAPA | (Sí No | 999999999999 | Cantidad de balastos para paletas |
| PESO BRUTO | (Sí No | 999999999999 | Peso bruto en GR |
| PESO NETO | (Sí No | 999999999999 | Peso neto en GR |
| EMPMAX | (Sí No | 999999999999 | Apilamiento máximo |
| ACTIVO | No | (Sí No | Activo |
| CAJA CERRADA | No | S/N | Indica si es una caja cerrada |
| CONTROL DE STOCK | No | S/N | Indica si controla stock |
| SEQEMB | No | 999999999999 | Número del embalaje |
| CODINTERNO | No | Código Interno de Producto en la Empresa con mayor precisión | |
| DECREDUCIDO2 | No | Descripción de embalaje reducida: UN, CX, LITRO, etc. Si se proporciona este campo, el campo UNCRREDUCED no se tendrá en cuenta y se utilizará para registrar el paquete. | |
| CNPJ_DEPOSITANTE | No | 99.999.999/9999-99 | CNPJ del depositante |
| INSCRESTADUAL_DEP | No | Registro estatal del depositante | |
| IDEMBERP | Sí | Campo de control ERP |
| Campo | Gracias | Mascarilla | Descripción |
|---|---|---|---|
| LLAVE | No | Campo de personalización - Talla 50 | |
| VALOR | No | Valor del campo de personalización - Tamaño 4999 |
Retorno
{ "headers": {}, "body": { "message": "El campo Código Interno es obligatorio. El campo CGC es obligatorio. El campo CNPJFAMILY es obligatorio. El campo ACTIVO es obligatorio. El campo Código Interno es obligatorio. El campo DESCR es obligatorio. El campo BAR es obligatorio. El campo factorConv es obligatorio. El campo de altura es obligatorio. El campo ancho es obligatorio. El campo BAR es obligatorio. El campo Peso bruto es obligatorio. El campo PesoLiquido es obligatorio.", "protocol": "434" }, "statusCode": "NOT_ACCEPTABLE", "statusCodeValue": 406 }
{ "headers": { }, "body": { "message": "Integración programada correctamente.", "protocol": "300" }, "statusCode": "CREADO", "statusCodeValue": 201 }
{ "headers": { }, "body": { "message": "ApiKey no encontró la configuración de integración, operación cancelada". }, "statusCode": "NO AUTORIZADO", "statusCodeValue": 401 }
{ "headers": { }, "body": { "message": "java.lang.NullPointerException" }, "statusCode": "INTERNAL_SERVER_ERROR", "statusCodeValue": 500 }
Ejemplo
[ { "idIntegracaoErp": "094550bc-89b0-4eff-92bf-cb0eb0573910", "cgc": "44.444.444/4444-44", "codReferencia": " ", "codigoInterno": "071011", "descr" : "TESTE DESCR VOICE PICKING - RESTV2 01", "tipoProd": "C", "cnpjFamilia": "44.444.444/4444-44", "subFamilia": "", "marca": " ", "subMarca" : "", "activo": "N", "color": "", "fabricado": " ", "estacional": "", "segregado": "", "fecha límiteValididad": "0", "fecha límiteVenta ": "", "prazoCritico": "", "subTipoProd": "", "ncm": "48191000", "codInterno": "071011", "descrProd": "TESTE DESCR VOICE PICKING - RESTV2 01", " codTipoProd": "", "cest": "", "motivoIsencao": "", "codigoProdAnvisa": "", "precoMaximoConsumidor": "0.0", "codigoInmetro": "", "kitExpExplodida": "N", "agruparArmazenagemCmpKit": "0", "preCadastro": "N", "codigoProdutoAnp": "", "descricaoProdutoAnp": "", "descrVoicePicking": null, "embalagens": [ { "idEmbERP": "094550bc-89b0 -4eff-92bf-cb0eb0573910", "codigoInterno": "071011", "bar": "0205500001102", "descrRedutor": "UN", "descr": "UN", "presentação": "", "factorConv" : 1, "alto": 20, "ancho": 0, "largo": 0, "saleunit": "", "purchaseunit": "", "lastre": 1, "layerqty": 1, "peso bruto" : 1, "pesoLiquido": 1, "empMax": 1, "active": "S", "caixaFedada": "N", "controlaEtoque": "N", "seqEmb": "1", "descrRedutor2" : "ONU", "cnpjDepositante": "44.444.444/4444-44" } ] } ]
Exportaciones senior de ERP
Exportaciones WMS x ERP Senior (Modelo V2)
Exportaciones de ERP
Guarniciones
Todas las integraciones REST v2 se presentarán con las mismas extensiones utilizadas para la integración de banco a banco.
|
Vea también: |





