Exportaciones WMS x ERP Senior (Modelo V2)
El objetivo principal de la integración entre Senior ERP y WMS en logística es mantener ambos sistemas actualizados, eliminando posibles fuentes de errores.
Este manual está destinado exclusivamente a la nueva integración con Senior ERP, que utiliza un proceso de integración basado en REST API con Senior Signal X. Si está interesado en revisar el antiguo modelo de integración entre Senior ERP y los sistemas WMS, consulteIntegración Senior ERP x WMS (Modelo V1).
(Referencia a WMS-4329)
Particularidades

Para integración con el ERP Senior/terceros disponer de datos de conexión con la plataforma SeniorX.
Parametrizaciones

Vaya a Configuración > Configuración de integración
Registro requerido por el Depositante. Se utilizará para integraciones de sistemas de terceros para la gestión de almacenamiento | WMS Senior. Y para que esto suceda es necesario generar la ApiKey en Storage Management | WMS Senior.
Para más detalles,acceso.

Vaya a Configuración > Configuración general > Botón Cambiar > pestaña REST
Configuración para comunicarse con el ERP Senior.
- Tipo de autenticación ERP senior pronto seráTipo de autenticación REST ERP:
- Clave de autenticación;
- Nombre de usuario y contraseña - cuando se selecciona esta opción, el sistema abre los siguientes campos para completar el grupo Configurar usando nombre de usuario y contraseña. El usuario {tenant} y la contraseña para la integración deben ser proporcionados por ERP Senior o un tercero.
- Usuario mayor pronto seráUsuario de autenticación REST
- Contraseña Senior X pronto seráContraseña de autenticación REST
- Nombre de usuario y contraseña con token de portador: este tipo de autenticación solo ocurre en sistemas que utilizan el Bearer Token como autenticación para recibir la exportación. Para este modelo de autenticación, el token se genera en el momento de la exportación. El nombre de usuario, la contraseña y la URL se utilizan para capturar el token mediante una publicación en la URL de autenticación.
- URL X senior pronto será
URL de autenticación REST: se debe proporcionar la URL de la plataforma Senior *login* ejemplo: https://{URL}/t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/login - ApiKey: clave utilizada para que sistemas de terceros consuman servicios Rest:Esta clave se genera según los datos de inicio de sesión y se utilizará para enviarla al ERP Senior.
Cada inquilino registra el WMS como una aplicación y asigna un rol y un usuario. Se genera una CLAVE API para esta aplicación, Gestión de almacenamiento | WMS Senior utiliza esta API CLAVE para conectarse a la plataforma SeniorX.
SeniorX devuelve un token, con una cierta validez (generalmente varios días), este token debe usarse en todas las comunicaciones integradas en el encabezado HTTPS. Cuando finaliza la validez y / o falla una autenticación, el token debe renovarse con la CLAVE API.
Cada CLAVE API es por inquilino, es decir, por Gestión de almacenamiento | WMS Senior. Debe generarse como un paso en la implementación y transportarse a Storage Management | WMS Senior, es decir, es una clave generada por Storage Management | WMS Senior al crear la configuración REST general

Vaya a Registro > Depositante > pestaña Integración de ERP para personas mayores
- Activar el parámetroIntegre con ERP sénior;
- Integre los depósitos senior de ERP: exporta datos de integración con el concepto de depósitos controlados por el ERP de Senior, siempre y cuando el parámetro esté activadoIntegre con ERP sénior;
- En este caso es necesario seleccionar en el campoIntegre con ERP sénior la opciónDescanso - Versión 2.
- Para más detalles,acceso.
Vaya a Registro > Depositante > pestaña Exportar
Para integraciones usando Rest V2, es necesario configurar las exportaciones para Rest Sinal SeniorX, con posibilidad de exportar las siguientes funcionalidades:
- Productos
- Situación de integración producto/embalaje
- Entidad
- Situación de integración de entidades
- Nota fiscal
- Situación de integración NF
- Recibo
- Acus
- Facturación
- Devolución de facturación automática
- movimiento interno
- I

Acceda a Registro de Depositante > Botón Estándar de Integración > Empaque
- Al realizar la importación, es decir incluyendo producto y empaque, la información de cubing es obligatoria, sin embargo cuando el ERP no cuenta con esta información, el WMS utilizará las configuraciones predefinidas para realizar el registro, por lo tanto, el envío en la integración de estos no será obligatoria, siempre y cuando existan los parámetros del Estándar de Integración.
Información requerida:- A
- ltura (mm)
- Ancho (mm)
- Longitud (mm)
- Lastr
- e


Para que el ERP Senior no necesite consultar a la Gestión de Almacenamiento | WMS Senior en todo momento, para saber si cierta información está lista para ser consumida o no, se dispara una Señal (Post) por parte de WMS Senior para que ERP Senior pueda realizar la consulta deseada (GET) en la Base de Datos de Gestión de Almacén | WMS Senior sólo cuando la información esté disponible.
Para que se produzca esta comunicación entre WMS > ERP, es necesario registrar la URL (/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarMovimentoSilt) en las siguientes integraciones:
Realice las posibilidades de registro de enlaces para integraciones de SeniorX Signal:
- EXP_SINAL_INVENTARIO ("Exportación de inventario al endpoint que recibe la señal de SeniorX")
- EXP_SINAL_OR ("Exportación del OR al punto final que recibe la señal en SeniorX")
- EXP_SINAL_FAT ("Exportación de facturación al terminal que recibe la señal de SeniorX")
- EXP_SINAL_SIT_ENTIDADE ("Exportación del estado de importación al endpoint de la entidad que recibe la señal en SeniorX")
- EXP_SINAL_SIT_NF ("Exportación del estado de importación al terminal que recibe la señal en SeniorX")
- EXP_SINAL_SIT_PRODUTO_PACKAGING ("Exportación del estado de importación al punto final del producto/embalaje que recibe la señal en SeniorX")
- EXP_SINAL_CONT_FAT_SERV ("Exportación de la factura del servicio al terminal que recibe la señal en Senior X")
Nota: la dirección URL debe ser evaluada al implementar la integración, ya sea que se utilice platform.senior.com.br o cloud-leaf.senior.com.br.

Para que el ERP reciba exportaciones desde Gestión de Almacén | WMS Senior, se realiza (Post) al ERP utilizando la URL registrada en la ganancia.
Para que se produzca esta comunicación entre WMS > ERP, la URL debe estar registrada.
/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/movimientoStock en las siguientes integraciones:
- EXPORTACAO_REST_CTRLAVARIA_MODMOV("Control de fallos del modelo MOV - Vía reposo")
- EXP_AJUSTEMOVTO_REST_MV("Enviar modelo MOV de descanso de ajuste de movimiento")
- EXPORTACAO_RETPRODRECUP_REST_MODMOV("Envío Devolución de Producto Recuperado TXT modelo MOV - Vía Rest")
- EXP_RESMANEJAMENTO_MOV_REST("Exportación Reubicación Entre Sectores Modelo MOV - REST")
- EXPORTACAO_BLOQDESBL_REST("Movimiento de stock - Bloqueo y desbloqueo de lotes")
/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/procesoProgresoSeparación en las siguientes integraciones
- EXP_ANDAMENTO_PED_REST("Exportación del Progreso del Pedido o Factura - REST")
/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/procesoCancelaciónWMS en las siguientes integraciones:
- EXP_CONFIRMACAO_CANCELAMENTO("Exportación de confirmación de cancelación de factura")
- EXPORTACAO_CANCELAMENTO_REST("Cancelación NF - Vía Rest")
Nota: la dirección URL debe ser evaluada al implementar la integración, ya sea que se utilice platform.senior.com.br o cloud-leaf.senior.com.br.
Integración

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 campo persona = J, 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 | |
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 |
CODIGOSORTER | 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/billing/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 | 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) | 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 | |||
registroEstIssuer | 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 | |||
valorAduanaDesp | |||
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 se vuelve 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" } ] } ] }
Particularidades

La integración de Facturación del campo CIFFOB se debe enviar según la documentación, que indica que el campo es texto, pero ERP Senior lo envía como un número, que tiene un comportamiento diferente, siguiendo la tabla de conversión:
JSON
Texto = ( "cifFob": "")
Número = ("cifFob": nulo)
Enviar como número, recordando que el mensaje presentado en el proceso de envío se refiere a los números estándar del sistema."El campo Tipo de envío es obligatorio y debe ser 1, 2, 4, 5, 6 o 7".
CIFFOB | Transportista - Método de carga a cuenta | Descripción del mensaje predeterminado en WMS) |
---|---|---|
"cifFob": 0 | Contratación de Flete por cuenta del Remitente (CIF) | "1" |
"cifFob": 1 | Contratación de Flete por cuenta del Destinatario (FOB) | "dos" |
"cifFob": 2 | Contratación de Fletes por cuenta de Terceros | "4" |
"cifFob": 3 | Sin ocurrencia de transporte | "5" |
"cifFob": 4 | Transporte propio a cargo del remitente. | "6" |
"cifFob": 5 | Transporte propio a cargo del destinatario. | "7" |
"cifFob": 6 | Consignatario | "3" |
Envío como texto, lo ideal es enviarlo de esta manera, para un mejor entendimiento y seguir las reglas de envío de las otras opciones como (banco a banco, TXT y REST).
CIFFOB | Transportista - Método de carga a cuenta |
---|---|
"cifFob": "1" | Contratación de Flete por cuenta del Remitente (CIF) |
"cifFob": "2" | Contratación de Flete por cuenta del Destinatario (FOB) |
"cifFob": "3" | Consignatario |
"cifFob": "4" | Contratación de Fletes por cuenta de Terceros |
"cifFob": "5" | Sin ocurrencia de transporte |
"cifFob": "6" | Transporte propio a cargo del remitente. |
"cifFob": "7" | Transporte propio a cargo del destinatario. |

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": "", "nomeTranspRedespacho": "", "enderecoTranspRedespacho": "" , "numeroEndTranspRedespacho": "", "bairroTranspRedespacho": "", "cidadeTranspRedespacho": "", "ufTranspRedespacho": "", "cepTranspRedespacho": "", "inscEstadualTranspRedespacho": "", "enderecoConsig": "", " cityConsig": "", "bairroConsig": "", "ufConsig": "", "cepConsig": "", "inscricaoEstConsig": "", "pessoaConsig": "", "codigoConsig": "", " razaoSocialConsig ": "", "fantasiaConsig": "", "numeroEndConsig": "", "complementEndConsig": "", "inscricaoEstEmitente": "", "codigoServicoTransportadora": "", "pickToLight": "", "router " : "", "codigoTipoPedido": "", "embarquePrioritario": "", "tipoRegimeTibutacao": "", "seqEntrega": 0, "razaoSocialIssuer": "", "fantasiaIssuer": "", "codigoRetencao": " ", "ValueIcmsRelieved": 0, "Purchaserpresence": "", "PaymentForm": "", "InputType": "", "BarSeparation": "", "WeekReceipt": "", "YearReceipt": "" , "semanaAvailizacao": "", "anoAvailizacao": "", "utilizaZPL": "", "codigoRastreio": "", "agrupadorPed": 0, "idOrdemTransSaida": 0, "codigoPaisDestinatario": "", "codigoServicoEtiquetaExterna " : "", "observacaoSeparacao": "", "inscricaoEstadualDepositante": "", "idIntegracaoErp": "", "dataPagto": "", "numeroOrdemProducao": "", "idMovimento": "", "idNotaFiscal" : 0, "cnpjConsig": "", "intCubometro": "", "dataPlanejamento": "", "invoicingDoisMomentos": "", "dataFaturamento": "", "canalVenda": "", "janelaInicio": " " , "janelaEnd": "", "codigoTipoRecebimento": "", "protocoloNfe": "", "dataRecebimentoNfe": "", "personalizacaoItem": [ { "key": "", "valor": "" } ] , "items": [ { "código interno": "", "numPedido": "", "cnpjDepositante": "", "cnpjEmitente": "", "sequencia": "", "tipo": "" , " idSeq": "", "codigoIndustria": "", "descricaoProduto": "", "barraProduto": "", "classificacaoFiscal": "", "st": "", "quantidade": "", "valorUnitario": "", "valorTotal": "", "aliquotaICMS": "", "aliquotaIPI": "", "ipi": "", "valorDesconto": "", "percentualDesconto": "", " descuento" : "", "totalLiquido": "", "tipoProduto": "", "cantidadeAtendida": "", "idNotaFiscal": "", "numberSeries": "", "tipoMaterial": "", "st3 ": "", "inscricaoEstEmitente": "", "dataExpirationLote": "", "descricaoRedutora": "", "idItemERP": "", "valorICMSdeonerado": "", "codigoProdutoAnvisa": "", "precoMaximoConsumidor" : " ", "baseICMS": "", "valorICMS": "", "importacaoCobFiscal": "", "aliquotaPIS": "", "basePIS": "", "valorPIS": "", "aliquotaConfins": "" , "baseConfins": "", "valorConfins": "", "originProduto": "", "remesa": "", "notaFiscal": "", "serieNF": "", "tipoPTL": " ", "tipoCaixaSep": "", "volumeCaixa": "", "messagemCaixa": "", "codigoSetor": "", "motivoIsencao": "", "numeroOrdemCompra": "", "obsItemSeparacao": "" , " itemsSpecificConference": [ { "numeroNf": "", "serieNf": "", "batch": "", "fecha de validez": "", "dataFabricacao": "", "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 |
PERSONA DESTINATARIA | Sí | Destinatario - Física = F / Legal = J | |
CÓDIGO DEL DESTINATARIO | Sí | Código del Destinatario | |
NOMBRE DEL RECIPIENTE | Sí | Destinatario - Nombre Corporativo | |
DISFRAZ DEL DESTINATARIO | No | Destinatario - Nombre comercial | |
DESTINATARIO CNPJ | Sí | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Destinatario - CNPJ para PJ / CPF para PF |
DIRECCIÓN DEL RECEPTOR | Sí | Dirección del receptor | |
NÚMERO FINAL DEL DESTINATARIO | No | Destinatario - Número de dirección | |
COMPLEMENTO DEL DESTINATARIO | No | Destinatario - Complemento, Si este campo tiene más de 50 caracteres déjelo vacío y use el campo COMPLEMENTO_DEST | |
BARRIO DESTINATARIO | Sí | Destinatario - Barrio | |
CEPDESTINATARIO | Sí | 99999999 | Destinatario - Código Postal |
CIUDAD RECEPTORA | Sí | Destinatario - Ciudad | |
TELÉFONO DEL DESTINATARIO | 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 | |
REGISTRO DEL ESTADO DESTINATARIO | No | Destinatario - Registro estatal | |
REGISTRO MUNICIPAL DE DESTINATARIOS | No | Destinatario - Registro Municipal | |
DIRECCIÓN DE ENTREGA | Sí, si los detalles de entrega están disponibles | Dirección de entrega | |
ENTREGA EN LA CIUDAD | Sí, si los detalles de entrega están disponibles | Entrega - Ciudad | |
VECINDARIO | 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 |
ENTREGA DEL CNPJ | Sí, si los detalles de entrega están disponibles | PJ: 99.999.999/9999-99 PF: 999.999.999-99 | Entrega - CNPJ o CPF |
ENTREGA DE MATRÍCULA ESTATAL | No | Entrega - Registro estatal | |
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 |
PRODUCTOS DE VALOR | Sí | 000000000.00 | Valor total de los productos |
VALOR TOTAL | Sí | 000000000.00 | Valor total de la nota |
NOMBRE DE LA COMPAÑÍA | Sí | Transportista - Nombre corporativo | |
CNPJTRANSPORTADORA | Sí | 99.999.999/9999-99 | Transportista - CNPJ |
DIRECCIÓN DEL TRANSPORTADOR | No | Transportista - Dirección | |
NÚMERO DE FIN DEL TRANSPORTADOR | No | Transportista - Número de dirección | |
BAIRROTRANSPORTADORA | No | Transportista - Barrio | |
CIUDAD DEL TRANSPORTE | No | Transportista - Ciudad | |
UFTRANSPORTADOR | No | Transportista - Estado | |
CEPTRANSPORTADORA | No | 99999999 | Transportista - CEP |
REGISTRO ESTATAL DE TRANSPORTE | 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) | 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 de Entrega - Nombre Corporativo | |
ENTREGA FANTASIA | No | Entidad de entrega - Nombre comercial | |
ENTRADA DE NUMEROS | No | Entidad de entrega - Número de dirección | |
COMPLEMENTO FINAL ENTREGA | 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 |
NOMBRE DE ENVÍO | No | Transportadora Redespacho - Razón social | |
DIRECCIÓN DE ENVÍO | No | Transporter Redespacho - Dirección | |
NÚMERO DE FINAL DE TRANSMISIÓN | No | Transportista Redespacho - Número de Dirección | |
BAIRROTRANSPREDESPACHO | No | Transportadora Redespacho - Barrio | |
CIUDADTRANSPREDESPACHO | No | Transporter Redespacho - Ciudad | |
UFTRANSPREDESPACHO | No | UF Empresa de transporte Redespacho - Estado | |
CEPTRANSPREDESPACHO | No | 99999999 | Empresa de transporte Redespacho - CEP |
INSCESTADUALTRANSPREDESPACHO | No | Transportador Redespacho - Registro Estatal | |
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ÓDIGO DE SERVICIO DE TRANSPORTADOR | 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. | |
RAZÓNOCIALEMISOR | Razón social del emisor | ||
EMISOR DE FANTASÍA | No | Razón social del emisor de la factura | |
RETENCIÓN DE CODIFICACIÓ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 |
UTILIZAZPL | |||
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) |
ORDEN DE TRANSMISIÓN | |||
CÓDIGO DE PAÍS DESTINATARIO | No | Código de país para destinatario/entrega extranjero | |
CÓDIGO DE SERVICIO ETIQUETAS EXTERNAS | No | Código de integración con servicio de etiquetas externo. Cuando se utiliza ZPL | |
SEPARACIÓN DE NOTAS | No | Nota dejada por el cliente en su pedido. Ej: solicito poner el nombre debajo del número | |
REGISTRO DE DEPOSITANTE ESTATAL | 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 | Monto 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 | Si 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 existe 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 | |
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. | |
KIT DE CÓDIGOS | No | Indica el código del kit al que pertenece el artículo. | |
IDITEMERP | No | Identificador de artículo 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 |
Retorno

{
"encabezados": {
},
"cuerpo": {
"message": "Integración programada exitosamente.",
"protocolo": "9394"
},
"statusCode": "CREADO",
"valor de código de estado": 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, "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. |
DESCRIPCIÓN SELECCIÓN | 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 UNITARIA | 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, "unidad de venta": "", "unidad de compra": "", "lastre": 1, "cantidad de capas": 1, "peso bruto" : 1, "pesoLiquido": 1, "empMax": 1, "active": "S", "caixaFedada": "N", "controlaEtoque": "N", "seqEmb": "1", "descrRedutor2" : "ONU", "cnpjDepositante": "44.444.444/4444-44" } ] } ]
Consulta

Punto final para integraciones de facturas de servicio. Incluye la nueva estructura de integración REST, que permite consultar datos relativos a la factura de servicio de un contrato.
Consultas ERP vía idFatura enviadas a través de la señal SeniorX.

Método: Obtener
URL: webresources/rest/v2/faturaContrato/{idFatura}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "identificador único": "4BD17990-2AA8-420C-B0B4-E17343F59838", "fecha": "2023-09-27 20:30:51", "cnpjDepositor": "44.444.444/4444-44", " cnpjUnit ": "11.111.111/1111-11", "numeroContrato": 5, "idFatura": 31, "inicioApuracao": "2023-09-24 00:00:00", "endinoApuracao": "2023-09 - 26 00:00:00", "dataApuracao": "2023-09-27 20:30:22", "valor": "1501", "status": 0, "codeAddress": 0, "vencimiento": " 2023-09-26 00:00:00", "descuento": "0", "valorLiquido": "1501", "codEndercoFat": 0, "parcial": 1, "codigoDepositorante": "00012", " codigoComplementar ": "12345", "items": [ { "service": "serv", "qty": 1, "unitvalue": "1", "totalvalue": "1", "type": 0, " descuento ": "0", "valorTotalLiquido": "1", "idFatura": 31 }, { "codeServico": "AV01", "servico": "AVULSO", "qty": 10, "valorUnitario": " 150 ", "valortotal": "1500", "tipo": 1, "descuento": "0", "valornettotal": "1500", "idfactura": 31 } ] }

"message": "Error debido a que no se encontró la factura del servicio."

Acceda a Gestión de contratos > Gestor de contratos > Botón Registrar > pestaña Exportar
- Al campoFactura de servicio, seleccione la opciónDESCANSO – Señal X Senior y se permitirá la exportación de la factura del servicio al ERP Senior, se deberá configurar el método de exportación de la factura en el registro del contrato.
- La factura sólo se genera cuando se finaliza el contrato. Para permitir la generación de una factura de servicio con el contrato vigente, deberá seleccionar la opciónExportar factura abierta. La factura exportada con el contrato aún vigente tiene el campo Parcial con valor 1; con un contrato finalizado, el campo tiene un valor de 0.
Vaya a Registro > Depositante > pestaña Integración de ERP para personas mayores
- La entidad pagadora también debe estar configurada para realizar la integración REST v2 con Senior X, como se define en el Registro de Depositante.
(Refiriéndose a WMSCT3-2593)

Punto final para integraciones de facturación. Incluye la nueva estructura de integración REST, que permite consultar datos de facturación.
ERP consulta vía idnf si la factura está disponible para facturación

Método: Obtener
URL: /webresources/rest/v2/invoicing/{idnf}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "uuid": "eb74f902-155d-4508-9574-298efe2b843e", "onda": "510", "totalCubagemVolume": 2000, "volúmenes": [ { "specie": "2", "pesoGruto": 10000 , "pesoLiquido": 10000 } ], "items": [ { "sequence": "1", "codigoProduto": "KIT345--1", "quantidade": 2, "quantidadeAtendida": 2, "packaging": "9000042441357", "coletaLote": "N", "series": [] } ], "protocoloNfe": "135220006307577", "dataRecebimentoNfe": "05/06/2022 10:15:03" }

{
"message": "Pedido no encontrado"
}

{
"message": "La configuración de integración no encontrada por la operación ApiKey cancelada."
}

{
“mensaje”: “java.lang.NullPointerException”
}

Punto final para integraciones de inventario. Incluye la nueva estructura de integración REST, que permite consultar datos relacionados con el Inventario.
Consulta ERP por idintegracao enviada por señal SeniorX.
(Referencia WMS-10977, WMS-11189)

Método: Obtener
URL:/ /webresources/rest/v2/inventario/{idintegracao}
Encabezado: apikey
Retorno

{ "idIntegracao": "4C76F4AE-1319-4819-ABD5-05684BAB7844", "idInventario": 12, "tipoInventario": "ROTATIVO", "dataFinalizacao": "26/07/2022 22:33:27", "situação ": "TERMINADO", "inventarioLote": [ { "idInventarioSequencia": "D696DB44-123-401E-B7EC-B2CDC8A1AC70", "cnpjDepositante": "44.444.444/4444-44", "codigoInterno": "PRD002", "stock": 3, "inventariado": 3, "bar": "2000000001401", "descr": "PRD002", "status": "N", "batch": "LOTIND002", "vencimiento": "01 /11/2022", "fabricacaoCalc": "07/01/2022", "codSetor": "07", "informacaoEspecificaLote": [ { "información": "INFO,SERIAL", "valor": "87,CBA -789-SL" }, { "información": "INFO,SERIAL", "valor": "88,RQP-654-SN" }, { "información": "INFO,SERIAL", "valor": "89 ,ZYX-123-SY" } ] } ] }

{ "mensaje": "Inventario no encontrado" }
o
{ "message": "¡No se encontró el paquete de integración!" }

- El ERP Senior recibe solo UNA información específica por producto, por ejemplo - SERIE. Si se envía más de un dato específico, aparecerá un error en el ERP.
- El WMS no tendrá este bloqueo, enviará toda la información específica registrada en el producto.
- Para obtener datos:
- fecha de vencimiento
- el vencimiento de los controles de inventario
- el producto/depositante cobra la fecha de vencimiento - lote de la industria
- el inventario verifica el lote de la industria - código de sector
- el sector/depositante con código de integración definido
- fecha de vencimiento


Punto final de la funcionalidad de integración de producto/paquete, donde el ERP consulta la información del Registro de integración utilizando el número de protocolo de integración, que informará el resultado final de la integración (error, éxito, programado), por lo tanto, esta consulta de producto existente es solo como un Registro de integración información.

Método: Obtener
URL: /webresources/rest/v2/produto/{protocolo}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

[ { "idLogIntegracao": "", "idIntegracaoErp": "", "codigoInterno": "", "descricaoProduto": "", "resultoIntegracao": "", "descricaoImportacao": "", "logIntegracaoEmbalagem": [ { "idLogIntegracao": "", "idEmbERP": "", "codigoInterno": "", "bar": "", "resultadoIntegracao": "", "descricaoImportacao": "" } ] } ]
Ejemplos

[ { "idLogIntegracao": "268866", "idIntegracaoErp": "a5da7d7d-5bef-4533-8d4c-650625897c32", "codigoInterno": "PRO00001", "descricaoProduto": "PRO00001", "resultadoIntegracao": "ÉXITO", "descriptionImportation": "PRODUCTO IMPORTADO EXITOSAMENTE. ID: 338", "logIntegracaoEmbalagem": [ { "idLogIntegracao": "268867", "idEmbERP": "a5da7d7d-5bef-4533-8d4c-650625897c32", "codigoInterno": "PRO00001", "bar": "UNPRO00001" , "resultIntegracao": "ÉXITO", "descriptionImportation": "EMBALAJE IMPORTADO EXITOSAMENTE." } ] } ]

Punto final de la funcionalidad de integración de entidades, donde el ERP consulta la información del Registro de integración utilizando el número de protocolo de integración, el cual informará el resultado final de la integración (error, éxito, programado), por lo tanto, esta consulta de entidad existente es solo para fines informativos del Registro de integración.

Método: Obtener
URL: /webresources/rest/v2/protocolo/{protocolo}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "message": "", "protocol": "", "logIntegracao": [ { "idLogIntegracao": "", "resultadoIntegracao": "", "idUsuario": "", "descricao": "", " codeInterno": "", "bar": "", "sql": "", "chaveIntegracao": "", "numPedido": "", "numNf": "", "agrupador": "" } ] }
Ejemplos

Punto final de la funcionalidad de integración de facturación, donde el ERP consulta la información del Registro de integración utilizando el número de protocolo de integración, que informará el resultado final de la integración (error, éxito, programado), por lo tanto, esta consulta de facturación existente es solo para información del Registro de integración.
Para consultar los datos de facturación existe la funcionalidad descritaen este tema.

Método: Obtener
URL: /webresources/rest/v2/protocolo/{protocolo}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "message": "", "protocol": "", "logIntegracao": [ { "idLogIntegracao": "", "resultadoIntegracao": "", "idUsuario": "", "descricao": "", " codeInterno": "", "bar": "", "sql": "", "chaveIntegracao": "", "numPedido": "", "numNf": "", "agrupador": "" } ] }
Ejemplos

Punto final de la funcionalidad de integración de pedidos, donde el ERP consulta la información del Registro de integración utilizando el número de protocolo de integración, que informará el resultado final de la integración (error, éxito, programado), por lo tanto, esta consulta de pedido existente es solo para información del Registro de integración.
Para consultar los datos del pedido existe la funcionalidad descritaen este tema.

Método: Obtener
URL: /webresources/rest/v2/protocolo/{protocolo}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "message": "", "protocol": "", "logIntegracao": [ { "idLogIntegracao": "", "resultadoIntegracao": "", "idUsuario": "", "descricao": "", " codeInterno": "", "bar": "", "sql": "", "chaveIntegracao": "", "numPedido": "", "numNf": "", "agrupador": "" } ] }
Ejemplos

Punto final para integraciones de pedidos de recibos. Incluye la nueva estructura de integración REST, que permite consultar datos relativos a la Orden de Recibo.
El ERP consulta el numOR enviado por SeniorX Signal.

Método: Obtener
URL: /webresources/rest/v2/o/{numO}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{ "o": 1020, "cnpjArmazem": "99.999.999/9999-99", "cnpjDepositante": "99.999.999/9999-99", "cnpjSender": "99.999.999/9999-99", " transportadorname": "transportername", "grossweight": 0, "dataRegistration": "0000-00-00 00:00:00", "qtyofVolumes": 0, "observation": "D", "status": "PROCESSED ", "plate": "plate", "cpfMotorista": "99.999.999/9999-99", "nomeMotorista": "nomeMotorista", "modalTransporte": "RODOVIARIO", "generarLotes": "Lotes Liberados", " recibo": { "dataInicioConferencia": "0000-00-00 00:00:00", "dataTerminoAlocacao": "0000-00-00 00:00:00" }, "items": [ { "idIntegracao": null , "codigoProduto": "codigoProduto", "quantidade": 0.0, "state": "N", "codIntegracaoSetor": null, "coletaLote": "N", "lote": null, "dataExpiration": null, " descricaoProduto": "descricaoProduto", "valorUnitarioGruto": 0.0, "idNotaFiscal": 0, "codigoInterno": 0, "sequencia": null, "serieProduto": [ { "tipo": "tipo", "valor": " valor" } ] } ] }

Campo | Mascarilla | Descripción |
---|---|---|
o | 999999999999 | Número de orden de recibo |
cnpjAlmacén | 99.999.999/9999-99 | CNPJ de la Unidad de Almacenamiento |
cnpjDepositor | 99.999.999/9999-99 | Identifica al depositante |
cnpjRemitente | 99.999.999/9999-99 | Cuando se informa, solo funciona con lotes de esta factura. Identifica el remitente de la factura. |
nombreTransportador | Identifica al transportista | |
peso bruto | 999999999999 | Peso bruto en gramos |
registro de fecha | DD/MM/AAAA HH:MM:SS | O fecha de registro |
cantidadVolúmenes | Cantidad de volumen | |
observación | Observación | |
estado | Estado de recepción del pedido | |
lámina | Placa del vehículo | |
cpfConductor | Conductor de vehículo | |
nombreConductor | Nombre del conductor | |
transportemodal | Informar si es Carretera, Ferrocarril o Aéreo | |
generar lotes | Información relacionada con el Tipo de Recibo asociado a la Orden de Recibo (OR). Las opciones disponibles son "Lotes Liberados", "Lotes Bloqueados" y "Transferencia de Estado" | |
fechaInicioConferencia | DD/MM/AAAA HH:MM:SS | Fecha de inicio de la conferencia |
fechaTérminoAsignación | DD/MM/AAAA HH:MM:SS | Fecha de finalización de la conferencia |

Campo | Mascarilla | Descripción |
---|---|---|
idIntegracao | Identificador único en el proceso de integración | |
códigoProducto | Código del Producto | |
cantidad | Cantidad de Producto | |
estado | Indica el estado del Pedido/Factura (N) Bien, (D) Dañado, (T) Truncado o Caducado | |
códigoIntegracaoSetor | Indica el código de integración del sector. | |
colecciónLote | Indica si se debe recolectar lote industrial | |
lote | Indica el lote del producto. | |
fecha de vencimiento | DD/MM/AAAA HH:MM:SS | Fecha límite de la conferencia |
Descripción del Producto | Descripción del producto | |
valorUnitarioBruto | Valor unitario bruto del producto | |
idNotaFiscal | Identificador único de factura | |
codigo interno | Número de factura | |
secuencia | Serie de la factura |

Campo | Mascarilla | Descripción |
---|---|---|
tipo | Indica una descripción de información específica del artículo. | |
valor | Indica contenido de información específica del elemento. |

{
"mensaje": "O no encontrado"
}

{
"message": "ApiKey no encontró la configuración de integración. Operación cancelada."
}

{
“mensaje”: “java.lang.NullPointerException”
}

Punto final para integraciones de pedidos. Incluye la nueva estructura de integración REST, que permite consultar los datos relativos al pedido.
ERP consulta a través de idnf si la nota está disponible para ordenar.

Método: Obtener
URL: /webresources/rest/v2/pedido/{idnf}
Encabezados:
- Apikey: clave utilizada para que sistemas de terceros consuman servicios Rest
Retorno

{
"uuid": "eb74f902-155d-4508-9574-298efe2b843e", "onda": "510", "totalCubagemVolume": 2000, "volúmenes": [ { "especie": "2", "pesoGruto": 10000, "pesoLiquido": 10000 } ], "items": [ { "sequencia": "1", "codigoProduto": "KIT345--1", "quantidade": 2, "quantidadeAtendida": 2, "packaging": " 9000042441357", "coletaLote": "N", "series": [] } ], "protocoloNfe": "135220006307577", "dataRecebimentoNfe": "05/06/2022 10:15:03" }

{
"message": "Pedido no encontrado"
}

{
"message": "La configuración de integración no encontrada por la operación ApiKey cancelada."
}

{
“mensaje”: “java.lang.NullPointerException”
}
Exportación ERP sénior

La integración de Gestión de Almacén Senior X Signal | WMS Senior para el ERP se realiza a través de registros de ganchos, por lo tanto cada integración realizada debe tener registrado su respectivo gancho.

Método: Publicar
URL: /t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarMovimentoSilt
Encabezados:
- Tipo de contenido: aplicación/JSON
- Apikey: clave utilizada para que la consuman sistemas de tercerosservicios de descanso
Envío

Acceda a Gestión de contratos > Administrador de contratos > Botón Registrar o Cambiar > pestaña Exportar > Factura de servicio > REST - Senior X Signal
Se refiere a la integración WMS para el ERP, con información de facturas de servicios contratados finalizados o vigentes, para que el usuario pueda consultar la información.
Descripción del gancho de registro.Exportación de la Factura de Servicio al endpoint que recibe la señal de SeniorX
Envío

{ "chavelayout": "vi_int_sinal_cont_fat_serv", "list": [ { "idmovimentacao": "Número de factura de servicio", "idprocessointegracao": "Número de agrupador de integración", "cnpjunidade": "almacén CNPJ" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de Factura de Servicio, el campo IDFATURA se enviará como identificador único. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. Para exportar la señal de Factura de Servicio, el WMS creará este número y lo enviará al ERP Senior para realizar el registro, y posteriormente consultar los datos de la factura. |
cnpjunidade | CNPJ del almacén. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > Pestaña Exportar > Agrupación de Movimiento Interno > Inventario > REST - Senior X Signal
Se refiere a la integración del WMS para el ERP, con la información del inventario completa, para que pueda consultar la información.
Descripción del gancho de registro.Exportación de inventario al endpoint que recibe la señal de SeniorX
Envío

{ "chavelayout": "vi_int_sinal_inventario", "list": [ { "idmovimentacao": "Número de inventario", "idprocessointegracao": "Número de agrupador de integración", "cnpjdepositante": "CNPJ del depositante" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de Inventario, se enviará el campo IDINVENTARIO como identificador único. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. Para exportar la señal de Inventario, el WMS creará este número y lo enviará al ERP Senior para realizar el registro, y posteriormente consultar los datos del inventario. |
cnpjdepositor | CNPJ del depositante. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > Pestaña Exportar > Agrupación de recibos > Devolución de recibo > REST - Senior X Signal
Se refiere a la integración WMS para el ERP, con la información de la Orden de Recibo, para que pueda consultar la información.
Descripción del gancho de registro.Exportación del OR al endpoint que recibe la señal en SeniorX.

JSON
{ "chavelayout": "vi_int_sinal_or", "list": [ { "idmovimentacao": "", "idprocessointegracao": "" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de Inventario, el campo IDLOTENF se enviará como identificador único. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > pestaña Exportar > Grupo de Facturación > Devolución de Facturación Automática. > DESCANSO - Señal X Senior
Se refiere a la integración WMS para el ERP, con información de Facturación, para que pueda consultar la información.
Descripción del gancho de registro.Exportar facturación al endpoint que recibe la señal de SeniorX.
Envío

{ "chavelayout": "vi_int_sinal_fat", "list": [ { "idmovimentacao": "", "idprocessointegracao": "" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de facturación se enviará el campo IDNOTAFISCAL como identificador único. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > Pestaña Exportar > Agrupación de entidades > Estado de integración de entidades > REST - Senior X Signal
Se refiere a la integración del WMS para el ERP, con la información de la Entidad, para que ésta pueda consultar la información.
Descripción del gancho de registro.Exportación del estado de importación al punto final de la entidad que recibe la señal en SeniorX.
Envío

{ "chavelayout": "vi_int_sinal_sit_entidade", "list": [ { "idmovimentacao": "", "idprocessointegracao": "" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de Inventario, el campo INTEGRACAOREST GROUPER se enviará como identificador único |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > pestaña Exportar > Agrupación de facturas > Estado de integración NF > REST - Senior X Signal
Se refiere a la integración de WMS para el ERP, con información de Factura, para que pueda consultar la información.
Descripción del gancho de registro.Exportación del estado de importación al punto final que recibe la señal en SeniorX.
Envío

{ "chavelayout": "vi_int_sinal_sit_nf", "list": [ { "idmovimentacao": "", "idprocessointegracao": "" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal de estado de integración de facturas, se enviará como identificador único el campo INTEGRACAOREST AGRUPADOR. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. |

Acceda a Registro > Depositante > Botón Registrar o Cambiar > Pestaña Exportar > Agrupación de productos > Situación de integración de producto/paquete > REST - Senior X Signal
Se refiere a la integración WMS para el ERP, con información de Producto/Embalaje, para que pueda consultar la información.
Descripción del gancho de registro.Exportación del estado de importación al punto final del producto/embalaje que recibe la señal en SeniorX.
Envío

{ "chavelayout": "vi_int_sinal_sit_prod_emb", "list": [ { "idmovimentacao": "", "idprocessointegracao": "" } ] }
Campo | Descripción |
---|---|
idmovimientocao | Identificador interno de Silt referente al proceso. Para la señal Producto/Embalaje se enviará como identificador único el campo INTEGRACAOREST AGRUPADOR. |
idprocesointegracao | Identificador único en el proceso de integración con el ERP Senior. |
Guarniciones

Signal Senior X es parte del flujo de integración de Rest V2, pero utiliza la estructura REST y para Signal Senior X se genera un archivo txt de ejemplo:señal-Rest746794id368-n.txt
Vaya a Integración > Integración de archivos > botón Combinar nuevamente
- tiene un filtroEstado,Operación EsPeríodo.
- Esta pantalla le permite monitorear el estado de la integración.
- Para Exportaciones de Señal Senior X se genera un archivo .txt, donde si hay algún error no será necesario volver a realizar el flujo.Mensaje.
Vaya a Integración > Integración de archivos > botón Descargar archivo exportado
- Sólo se pueden descargar archivos exportados en formato JSON en el modelo REST V2.
Mensajes de ejemplo:
- No hay ganchos registrados para exportación: Exportación de facturación al terminal que recibe la señal en Senior
- ÉXITO: [URL(https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarMovimentoSilt) IDGANCHO(5) - STATUSCODE(202) ]
- Problemas encontrados: ERROR: [URL(https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/erp_isl/int_integrador/signals/processarMovimentoSilt) IDGANCHO(9) - STATUSCODE (401)]
Código de estado | Descripción de los códigos de estado HTTP |
---|---|
200 | Indica el éxito de la solicitud. |
202 | Indica el éxito de la solicitud. |
401 | Indica que la solicitud es incorrecta. En el ejemplo anterior, Gestión de almacenamiento | WMS Senior pudo acceder a la ruta para enviar la información a ERP Senior, pero Gancho tenía el registro incorrecto para enviar la exportación. |
500 | Indica un error interno del servidor. En este escenario, indica que Gestión de almacenamiento | WMS Senior no pudo acceder a la ruta para enviar la información a ERP Senior. Se requerirá una evaluación senior de soporte de ERP |

Todas las integraciones REST v2 se presentarán con las mismas extensiones utilizadas para la integración de banco a banco.