Productos

Descrição

El endpoint PostAddProduct es responsable del registro de un nuevo producto en el sistema MIMS. El registro puede ser visualizado en la pantalla CAD223

Cómo registrar un nuevo producto

Request HTTP POST

Tipo de Solicitud	URL Ejemplo
POST	`{{url_base}}/PostAddProduct`
Ejemplo	`http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/"PostAddProduct"`

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ProductNo	String(25)	Sí	Código externo del producto
Name	String(60)	Sí	Descripción del producto
ReducedName	String(28)	Sí	Descripción reducida del producto
ProductionCode	String(10)	Sí	Código del producto en la producción
PackageNo	String(25)	Sí	Código externo del empaque
FamilyNo	String(25)	Sí	Código externo de la familia del producto
BrandNo	String(25)	Sí	Código externo de la marca del producto
MaterialNo	String(25)	Sí	Código externo del material
AnimalTypeNo	String(25)	Sí	Código externo del tipo de animal
IntegrationNo	String(25)	No	Código integrado del producto
UnitMeasurementNo	String(25)	No	Código externo de la unidad de Medida de la Pieza
BillingUnitMeasurementNo	String(25)	No	Código externo de la Unidad de Medida de Facturación
ValidationRuleNo	String(25)	No	Código externo de la regla de validez
LabelTemplateCode	Integer	No	Modelo Etiqueta
PreIdentificationLabelTemplateCode	Integer	No	Modelo Etiqueta Pre-Identificación
PrimaryLabelTemplateCode	Integer	No	Modelo Etiqueta Primaria
Condition	ConditionProduct	Sí	Enumerador con los posibles valores para la Condición del producto: `cdFresh` (Fresco), `cdDeepChill` (Refrigerado) o `cdFrozen` (Congelado)
Species	SpeciesProduct	Sí	Enumerador con los posibles valores para la Especie del producto: `spcWhole` (Entero), `spcCut` (Corte), `spcGiblets` (Menudencia), `spcOther` (Otro) o `spcByProduct` (Subproducto)
RawMaterialState	RawMaterialStateProduct	Sí	Enumerador con los posibles valores para el Estado del producto: `stInNatura` (In Natura) o `stSazonado` (Sazonado)
EAN13	String(13)	No	EAN 13
EAN14	String(14)	No	EAN 14
MinTolerancePercentage	Float	No	Porcentaje de Tolerancia Mínima
MaxTolerancePercentage	Float	No	Porcentaje de Tolerancia Máxima
AnimalsInPackageQty	Integer	No	Cantidad de Animales en el Empaque
ProductInPackageQty	Integer	No	Cantidad de Productos en el Empaque
MinimumCapacity	Float	No	Capacidad Mínima
AverageCapacity	Float	No	Capacidad Promedio
MaximumCapacity	Float	No	Capacidad Máxima
StandardCapacity	Float	No	Capacidad Estándar
ProductBranchList	ProductBranchList	Sí	Lista de informaciones del producto por sucursal
OverwriteExists	Boolean	No	Bandera que indica que los datos deben ser sobrescritos en caso de que el registro ya exista

Notas

En los parámetros LabelTemplateCode, PreIdentificationLabelTemplateCode y PrimaryLabelTemplateCode, validamos si el valor pasado es mayor que 0 y verificamos la existencia solamente de las etiquetas que poseen el código mayor o igual a 1000, pues son las etiquetas que poseen registro en la view "VW_ETIQUETA". Si la etiqueta no estuviera registrada, generamos la excepción "La etiqueta "%s" informada no fue encontrada!"
Asegúrese de que los parámetros ProductNo, FamilyNo, BrandNo, MaterialNo, AnimalTypeNo, BranchNo y otros códigos externos sean válidos y no duplicados en el sistema MIMS. :::ción El endpoint PostAddProduct es responsable del registro de un nuevo producto en el sistema MIMS. El registro puede ser visualizado en la pantalla CAD223

📝 Objeto ProductBranchList

Descripción

El objeto ProductBranchList representa una lista de informaciones del producto por sucursal.

Parámetros de Entrada

Parámetro Tipo Obligatorio Descripción
BranchNo String(25) Sí Código externo de la sucursal
Name String(120) No Descripción del producto en la sucursal
ProductionGroupNo String(20) No Descripción del grupo de producción
ClassifierGridNo String(25) No Código externo de la grilla clasificadora
WarehouseNo String(25) No Código externo del almacén
StructureNo String(25) No Código externo de la estructura analítica
UnitMeasurementNo String(25) No Código externo de la unidad de Medida de la Pieza
UnitMeasurementIndividualNo String(25) No Código externo de la unidad de Medida de la Pieza individual
StockSequestrationDays Integer No Días Secuestro en stock
ToleranceStandardDateDays Integer No Días de tolerancia de la fecha estándar
DefaultQuantityinPallet Integer No Cantidad estándar de empaques para montaje del palet
UnidPartQty Integer No Cantidad de piezas por unidad
AnimalsInPackageQty Integer No Cantidad de animales en el empaque
ProductInPackageQty Integer No Cantidad de productos en el empaque
MinRawMaterialPercentage Float No Porcentaje Mínimo de Producto Materia Prima
WeightToleranceUponGroupedWeighing
Percentage Float No Porcentaje de Tolerancia de Peso en el Pesaje Agrupado
MaxTolerancePercentage Float No Porcentaje de Tolerancia Máxima del Peso
MinTolerancePercentage Float No Porcentaje de Tolerancia Mínima del Peso
PreIdentificationLabelTemplateCode Integer No Modelo Etiqueta Pre-Identificación
PrimaryLabelTemplateCode Integer No Modelo Etiqueta Primaria
RegisterAgricultureMinistryCode String(14) Sí Número Registro Ministerio de Agricultura
AgricultureMinistryName String(180) Sí Descripción en el Ministerio de Agricultura
IdentifiesType IdentifiesType No Enumerador con los posibles valores para el Tipo de Identificación del producto: itOpticalReading (Lectura Óptica) o itManualTyping (Digitación Manual)
DispatchType DispatchType Sí Enumerador con los posibles valores para el Tipo de Expedición del producto: dtOpticalReading (Lectura Óptica), dtManualDispatching (Expedición Manual), dtAutomaticDispatching (Expedición Automática) o dtInBulk (A Granel)
OwnProduction OwnProduction No Enumerador con los posibles valores para la Producción Propia: opYes (Sí), opNo (No) o opBoth (Ambos)
IsInactive Boolean No Bandera que indica que el producto está inactivo
HasInactiveTunnelControl Boolean No Bandera que indica que el Control de Túneles está Inactivo
OverwriteExists Boolean No Bandera que indica que los datos deben ser sobrescritos en caso de que el registro ya exista

Observación

Nos parâmetros PreIdentificationLabelTemplateCode e PrimaryLabelTemplateCode, validamos se o valor passado é maior que 0 e verificamos a existência apenas das etiquetas que possuem o código maior ou igual a 1000, pois são as etiquetas que possuem registro na view "VW_ETIQUETA". Se a etiqueta não estiver registada, geramos a exceção “A etiqueta "%s" informada não foi encontrada!”

Nos parâmetros WarehouseNo, ClassifierGridNo e StructureNo, quando a requisição for uma alteração de produto e o valor informado for igual ao texto de integração padrão (definido na variável StandardIntegration do arquivo INI), o sistema não atualiza o valor desses campos. Nesses casos, o valor já existente no cadastro do produto será mantido.

Parámetro	Tipo	Obligatorio	Descripción
BranchNo	String(25)	Sí	Código externo de la sucursal
Name	String(120)	No	Descripción del producto en la sucursal
ProductionGroupNo	String(20)	No	Descripción del grupo de producción
ClassifierGridNo	String(25)	No	Código externo de la grilla clasificadora
WarehouseNo	String(25)	No	Código externo del almacén
StructureNo	String(25)	No	Código externo de la estructura analítica
UnitMeasurementNo	String(25)	No	Código externo de la unidad de Medida de la Pieza
UnitMeasurementIndividualNo	String(25)	No	Código externo de la unidad de Medida de la Pieza individual
StockSequestrationDays	Integer	No	Días Secuestro en stock
ToleranceStandardDateDays	Integer	No	Días de tolerancia de la fecha estándar
DefaultQuantityinPallet	Integer	No	Cantidad estándar de empaques para montaje del palet
UnidPartQty	Integer	No	Cantidad de piezas por unidad
AnimalsInPackageQty	Integer	No	Cantidad de animales en el empaque
ProductInPackageQty	Integer	No	Cantidad de productos en el empaque
MinRawMaterialPercentage	Float	No	Porcentaje Mínimo de Producto Materia Prima
WeightToleranceUponGroupedWeighing Percentage	Float	No	Porcentaje de Tolerancia de Peso en el Pesaje Agrupado
MaxTolerancePercentage	Float	No	Porcentaje de Tolerancia Máxima del Peso
MinTolerancePercentage	Float	No	Porcentaje de Tolerancia Mínima del Peso
PreIdentificationLabelTemplateCode	Integer	No	Modelo Etiqueta Pre-Identificación
PrimaryLabelTemplateCode	Integer	No	Modelo Etiqueta Primaria
RegisterAgricultureMinistryCode	String(14)	Sí	Número Registro Ministerio de Agricultura
AgricultureMinistryName	String(180)	Sí	Descripción en el Ministerio de Agricultura
IdentifiesType	IdentifiesType	No	Enumerador con los posibles valores para el Tipo de Identificación del producto: `itOpticalReading` (Lectura Óptica) o `itManualTyping` (Digitación Manual)
DispatchType	DispatchType	Sí	Enumerador con los posibles valores para el Tipo de Expedición del producto: `dtOpticalReading` (Lectura Óptica), `dtManualDispatching` (Expedición Manual), `dtAutomaticDispatching` (Expedición Automática) o `dtInBulk` (A Granel)
OwnProduction	OwnProduction	No	Enumerador con los posibles valores para la Producción Propia: `opYes` (Sí), `opNo` (No) o `opBoth` (Ambos)
IsInactive	Boolean	No	Bandera que indica que el producto está inactivo
HasInactiveTunnelControl	Boolean	No	Bandera que indica que el Control de Túneles está Inactivo
OverwriteExists	Boolean	No	Bandera que indica que los datos deben ser sobrescritos en caso de que el registro ya exista

Retorno

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

Ejemplo de Request

curl --location --request POST '{{url_base}}/PostAddProduct' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
    "ProductNo": "PROD001",
    "Name": "Nombre del producto Prueba",
    "ReducedName": "Producto Prueba",
    "ProductionCode": "FRG001",
    "PackageNo": "EMBA123", 
    "FamilyNo": "FAMI123",
    "BrandNo": "MARCA123",
    "MaterialNo": "1117",
    "IntegrationNo": "INT123456",
    "AnimalTypeNo": "TPAVE123", 
    "ValidationRuleNo": "VAL001",
    "LabelTemplateCode": 5011, 
    "PreIdentificationLabelTemplateCode": 5014,
    "PrimaryLabelTemplateCode": 5015, 
    "UnitMeasurementNo": "UN", 
    "BillingUnitMeasurementNo": "UN", 
    "ValidityRuleNo": "VALI123",
    "Condition": "cdFresh", 
    "Species": "spcCut",  
    "RawMaterialState": "stInNatura", 
    "EAN13": "1234567899874", 
    "EAN14": "12345678998745", 
    "MaxTolerancePercentage": 85, 
    "MinTolerancePercentage": 60, 
    "AnimalsInPackageQty": 10,  
    "ProductInPackageQty": 30, 
    "MaximumCapacity": 100, 
    "AverageCapacity": 50, 
    "MinimumCapacity": 20,  
    "StandardCapacity": 60, 
    "OverwriteIfExists": true,
    "ProductBranchList":[
        {
            "BranchNo": "BR001",
            "Name": "Producto Ejemplo - Sucursal",
            "ProductionGroupNo": "GRP001",
            "ClassifierGridNo": "CLF001",
            "WarehouseNo": "WH001",
            "StructureNo": "STR001",
            "UnitMeasurementNo": "UND001",
            "UnitMeasurementIndividualNo": "UNDIND001",
            "StockSequestrationDays": 7,
            "ToleranceStandardDateDays": 3,
            "DefaultQuantityinPallet": 20,
            "UnidPartQty": 10,
            "AnimalsInPackageQty": 5,
            "ProductInPackageQty": 50,
            "MinRawMaterialPercentage": 1.5,
            "WeightToleranceUponGroupedWeighingPercentage": 2.0,
            "MaxTolerancePercentage": 4.0,
            "MinTolerancePercentage": 1.0,
            "PreIdentificationLabelTemplateCode": 1001,
            "PrimaryLabelTemplateCode": 1002,
            "RegisterAgricultureMinistryCode": "REG1234567890",
            "AgricultureMinistryName": "Ministerio de Agricultura - Unidad Ejemplo",
            "IdentifiesType": "itOpticalReading",
            "DispatchType": "dtAutomaticDispatching",
            "OwnProduction": "opYes",
            "IsInactive": false,
            "HasInactiveTunnelControl": false,
            "OverwriteIfExists": true
        }
    ]
}'

Ejemplo de Response

{
  "WebServiceReturn": {
      "Status": "wrsSuccess",
      "ErrorCode": "",
      "Message": "",
      "Actor": "",
      "ReturnQuestion": null
  },
  "ProductCode": 789
}

Descrição​

Cómo registrar un nuevo producto​

Parámetros de Entrada​

📝 Objeto ProductBranchList​

Descripción​

Parámetros de Entrada​

Retorno​

Ejemplo de Request​

Ejemplo de Response​

Descrição

Cómo registrar un nuevo producto

Parámetros de Entrada

📝 Objeto ProductBranchList

Descripción

Parámetros de Entrada

Retorno

Ejemplo de Request

Ejemplo de Response