Universal import of goods from XML with characteristics, attributes, photos, and categories

🎯 

Goal:

Create a universal import processing for products from XML in BAS Small Company PROF, which:

• supports different XML structures (Prom, Hotline, custom YML),

• automatically detects characteristics and attributes, and creates them if they do not exist.

• Creates separate categories for different files

• creates a category hierarchy (reference “Nomenclature Groups”),

• uploads images by URL into the product card or characteristic.

⚙️ 

Main features:

1. Flexible XML parser:

   
   

   • Works with PromUA/YML-like structure files.

   • Supports key tags: <offer>, <group_id>, <vendor>, <param name="...">, <picture>, <categoryId>, <barcode>, <vendorCode>.

2. Grouping by group_id:

   
   

   • Offers with the same group_id = one product with options (characteristics).

3. Automatic detection:

   
   

   • param name with the same value → attribute (requisite);

   • param name with different values (or missing in some) → characteristic.

4. Nomenclature:

   
   

   • One nomenclature card per group_id.

   • Requisites/properties are stored in BAS directories.

   • Characteristics are created with a unique set of parameters or taken from existing ones.

5. Prices and stock levels:

   
   

   • Price recorded from <price> tag.

   • Ability to create virtual stock levels already configured in my setup under "Stock of Nomenclature for Contractors".

6. Category hierarchy:

   
   

   • Based on <categoryId> and <categories><category id="X" parentId="Y">Name</category></categories>.

   • Automatic creation of nested nomenclature groups (reference “Nomenclature Groups”).

7. Photos (mandatory):

   
   

   • Uploading images via <picture> tag:

     
     

     • If multiple <picture> — take the first as main, others as additional.

   • Photo saving should follow parameters and pass through image processing already integrated into BAS if the file size exceeds 3MB.

8. Execution:

   
   

   • My setup includes scheduled exchanges, so it is necessary that this new exchange can be scheduled according to the regulations.

9. The typical file for upload is attached below.