Embalajes

El endpoint PostAddPackage es responsable del registro de un nuevo embalaje en el sistema MIMS. Este registro puede ser visualizado en la pantalla CAD016.

---

Cómo registrar un embalaje

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddPackage
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddPackage"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
PackageNo	String(25)	Sí	Código externo del embalaje
PackageName	String(40)	Sí	Descripción del embalaje
ShortName	String(15)	Sí	Descripción resumida del embalaje
UnitMeasurement	String(2)	Sí	Unidad de medida del embalaje
PackageTypeNo	String(25)	Sí	Código externo del tipo de embalaje
PackageClassification	PackageClassification	Sí	Enumerador con los posibles valores para la Clasificación/Especie del Embalaje: pcNotAssigned (No Asignado), pcPackaging (Embalaje), pcBag (Bolsa), pcBasePackaging (Embalaje Base), pcPallet (Pallet) o pcCage (Jaula)
Tare	Float	No	Tara del embalaje
TareUnitMeasurement	String(2)	Sí	Unidad de medida de la tara del embalaje
PackageLength	Float	No	Longitud del embalaje
PackageHeight	Float	No	Altura del embalaje
PackageWidth	Float	No	Ancho del embalaje
DimensionUnitMeasurement	String(2)	Sí	Unidad de medida de las dimensiones del embalaje
PackageMeasurementList	PackageMeasurementList	No	Objeto con las informaciones de las Medidas del Embalaje
PackageVariationList	PackageVariationList	No	Objeto con las informaciones de las Variaciones del Embalaje
IsActive	Boolean	No	Flag que indica si el embalaje está activo o no
OverwriteIfExists	Boolean	No	Flag para sobrescribir si el embalaje ya existe

Nota

• El parámetro PackageTypeNo, cuando la solicitud sea una modificación del embalaje y el valor informado sea igual al texto de integración estándar (información definida en la variable "PadraoIntegracao" en la clave "GERAL" del INI), el sistema no actualiza el valor de este campo. En este caso, el valor ya existente en el registro del embalaje será mantenido.

📝 Objeto PackageMeasurementList

El objeto PackageMeasurementList representa una lista de las informaciones de las Medidas del Embalaje.

Parámetros de Entrada

Parámetros	Tipo	Obligatorio	Descripción
BranchNo	String(25)	Sí	Código externo de la filial
Tare	Float	Sí	Tara del embalaje
PackageMeasurementValue	Float	No	Valor del embalaje
PackageMeasurementNotes	String(2000)	No	Observaciones referentes a las medidas del embalaje
IsControlled	Boolean	No	Flag que indica si el embalaje es controlado o no

📝 Objeto PackageVariationList

El objeto PackageVariationList representa una lista de las informaciones de las Variaciones del Embalaje.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
PackageVariationNo	String(15)	Sí	Código externo de la variación
VariationName	String(40)	Sí	Descripción de la variación del embalaje
IdentificationCode	Integer	Sim	Código de identificação
PackageVariationClassification	PackageClassification	No	Enumerador con los posibles valores para la Clasificación/Especie del Embalaje: pcNotAssigned (No Asignado), pcPackaging (Embalaje), pcBag (Bolsa), pcBasePackaging (Embalaje Base), pcPallet (Pallet) o pcCage (Jaula)
Tare	Float	Sim	Tara da variação da embalagem
TareUnitMeasurement	String(2)	Sí	Unidad de medida de la tara de la variación del embalaje
VariationLength	Float	Sim	Comprimento da variação da embalagem
VariationHeight	Float	Sim	Altura da variação da embalagem
VariationWidth	Float	Sim	Largura da variação da embalagem
DimensionUnitMeasurement	String(2)	Sim	Unidade de medida das dimensões da variação da embalagem
ReweighOverToleranceWeight	Float	Não	Peso acima de tolerância em repesagens
ReweighUnderToleranceWeight	Float	Não	Peso abaixo de tolerância em repesagens
ReweighOverTolerancePercentage	Float	Não	Percentual acima de tolerância em repesagens
ReweighUnderTolerancePercentage	Float	Não	Percentual abaixo de tolerância em repesagens
IsStandardVariation	Boolean	Não	Flag que indica se esta variação é a variação padrão da embalagem
IsFinalVariation	Boolean	Não	Flag que indica se esta variação é a variação final em manutenções de troca de variações

Observação

• Se ReweighOverToleranceWeight for informado, é necessário informar também o ReweighUnderToleranceWeight, e vice-versa.
• Se ReweighOverTolerancePercentage for informado, é necessário informar também o ReweighUnderTolerancePercentage, e vice-versa.

---

Retorno

Parámetro	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Informaciones estándar de respuesta del WebService en la ejecución del método
PackageCode	Integer	Sí	Código interno del Embalaje generado en el sistema MIMS

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddPackage"' \
--header 'Content-Type: application/json' \
--data '{
  "PackageNo": "PKG-001-2025",
  "PackageName": "Embalaje Estándar",
  "ShortName": "Caja P",
  "UnitMeasurement": "UN",
  "PackageTypeNo": "TIPOEMBA1",
  "PackageClassification": "pcBasePackaging",
  "Tare": 2.5,
  "TareUnitMeasurement": "KG",
    "PackageLength": 30.0,
    "PackageHeight": 20.0,
    "PackageWidth": 15.0,
  "DimensionUnitMeasurement": "UN",
  "IsActive": true,
  "PackageMeasurementList": [
    {
      "BranchNo": "101",
      "Tare": 2.5,
      "PackageMeasurementValue": 100.0,
      "PackageMeasurementNotes": "Medición estándar P",
      "IsControlled": false
    }
  ],
  "PackageVariationList": [
    {
      "PackageVariationNo": "PKG-001-V1",
      "VariationName": "Variación Estándar",
      "IdentificationCode": 1333,
      "PackageVariationClassification": "pcBasePackaging",
      "Tare": 3.5,
      "TareUnitMeasurement": "KG",
      "VariationLength": 31.0,
      "VariationHeight": 21.0,
      "VariationWidth": 16.0,
      "DimensionUnitMeasurement": "UN",
            "ReweighOverToleranceWeight": 0.10,
            "ReweighUnderToleranceWeight": 0.05,
            "ReweighOverTolerancePercentage": 2.0,
            "ReweighUnderTolerancePercentage": 2.0,
      "IsStandardVariation": true,
      "IsFinalVariation": false
    }
  ],  
  "OverwriteIfExists": false
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    },
    "PackageCode": 26
}

---

🐞 Posibles Errores

Código	Mensaje
APK‑001	¡El embalaje "PackageNo" informado ya existe!
APK‑002	¡Existen variaciones de embalaje cuya clasificación no corresponde a la clasificación informada ([valor enviado en la solicitud]) para el embalaje!
APK‑003	¡La clasificación informada para este embalaje ([valor enviado en la solicitud]) difiere de la clasificación de la variación existente!
APK‑004	¡Si el parámetro "ReweighOverToleranceWeight" es informado, el parámetro "ReweighUnderToleranceWeight" también debe ser informado, y viceversa!
APK‑005	¡Si el parámetro "ReweighOverTolerancePercentage" es informado, el parámetro "ReweighUnderTolerancePercentage" también debe ser informado, y viceversa!
APK‑006	¡Este embalaje ya fue utilizado en la paletización. No es permitido alterar la clasificación previamente definida (pcPallet)!
APK‑007	¡Este embalaje está vinculado al producto ([código de producción del producto]), que está activo. El embalaje no puede ser definido como inactivo!
APK‑008	¡El código de identificación ([valor enviado en la solicitud]) informado en el parámetro IdentificationCode en el índice [[código del índice]] ya está asociado a otro paquete!

---