[
    {
        "useIf": {
            "blField": "payment_method",
            "condition": "startsWith",
            "value": "Inpost"
        },
        "blField": "admin_comments",
        "operation": "append",
        "separator": "-",
        "prefix": "Paczkomat",
        "externalField": "note",
        "suffix": "suffix",
        "modifiers": [
            [
                "replace",
                "inpost",
                "paczomat"
            ],
            [
                "substr",
                "10",
                "50"
            ],
            [
                "trim"
            ],
            [
                "addText",
                "jaki\u015b dodatkowy teks"
            ]
        ]
    }
]

useIf

Pozwala określić warunki dla których reguła będzie użyta

Allows you to specify conditions for which the rule will be used

blField

Ścieżka do pola w zamówieniu w BL

Path to the field in the order in BL

externalField

Pole w zewnętrznym systemie, możemy wskazać dowolne pole w zamówieniu z zewnętrznego systemu
w przypadku gdy pole jest elementem tablicy, należy wskazać po którym z pól tablicy chcemy filtrować wybierając pole z listy rozwijanej 'if' oraz wprowadzić wartość do pola 'equals'
np additional_fields[].value if field_id=3, pobierze wartość pola 'value' jeśli pole field_id będzie miało wartość 3

[
    [
        "value"=>"ABC",
        "field_id"=>7
    ],
    [
        "value"=>"XYZ",
        "field_id"=>3
    ]
]

$blOrder=[
    "products"=>[
        [   
            "id"=>1,
            "name"=>"Produkt 1",
            "sku"=>""
        ],
        [   
            "id"=>2,
            "name"=>"Produkt 2",
            "sku"=>""
        ]
    [
];
$externalOrder=[
    "items"=>[
        [
            "code"=>"AWS",
            "product_id"=>2
        ],
        [
            "code"=>"XYZ",
            "product_id"=>1
        ]
    ]
]

$blOrder=[
    "products"=>[
        [   
            "id"=>1,
            "name"=>"Produkt 1",
            "sku"=>"XYZ"
        ],
        [   
            "id"=>2,
            "name"=>"Produkt 2",
            "sku"=>"AWS"
        ]
    [
];

$blOrder=[
    "products"=>[
        [   
            "id"=>1,
            "name"=>"Produkt 1",
            "sku"=>"AWS"
        ],
        [   
            "id"=>2,
            "name"=>"Produkt 2",
            "sku"=>"XYZ"
        ]
    [
];

$blOrder=[
    "extra_field_1"=>"XYZ",    
];

$blOrder=[
    "extra_field_1"=>"XYZ,ABC",    
];

Field in the external system, we can specify any field in the order from the external system. In the case where the field is an element of an array, you should indicate after which field of the array you want to filter by selecting a field from the dropdown list 'if' and entering a value into the 'equals' field. For example, `additional_fields[].value if field_id=3` will retrieve the 'value' of the field if the 'field_id' has a value of 3: json [ { "value": "ABC", "field_id": 7 }, { "value": "XYZ", "field_id": 3 } ] You can also link two tables together. To do this, you should use the abbreviation 'tgt.FIELD_NAME' as the matching value, where 'FIELD_NAME' is the name of the field from the first table. For instance:

$blOrder = [
    "products" => [
        [
            "id" => 1,
            "name" => "Product 1",
            "sku" => ""
        ],
        [
            "id" => 2,
            "name" => "Product 2",
            "sku" => ""
        ]
    ]
];

$externalOrder = [
    "items" => [
        [
            "code" => "AWS",
            "product_id" => 2
        ],
        [
            "code" => "XYZ",
            "product_id" => 1
        ]
    ]
];

$blOrder = [
    "products" => [
        [
            "id" => 1,
            "name" => "Product 1",
            "sku" => "XYZ"
        ],
        [
            "id" => 2,
            "name" => "Product 2",
            "sku" => "AWS"
        ]
    ]
];

$blOrder = [
    "products" => [
        [
            "id" => 1,
            "name" => "Product 1",
            "sku" => "AWS"
        ],
        [
            "id" => 2,
            "name" => "Product 2",
            "sku" => "XYZ"
        ]
    ]
];

$blOrder = [
    "extra_field_1" => "XYZ"
];

$blOrder = [
    "extra_field_1" => "XYZ,ABC"
];

operation

Operacja na wartościach

Operation on values

modifiers

Modyfikator wartości, przyjmuję wartości według schematu podanego poniżej, modyfikatorów można użyć wiele rozdzielając je znakiem & lub jako tablice,
parametry modyfikatorów podajemy po przecinku, lub jako kolejne elementy tablicy, której kluczem zero jest nazwa modyfikatora

Value modifier, it accepts values according to the scheme given below, you can use many modifiers by separating them with the & sign or as an array,
modifier parameters are given after a comma, or as subsequent elements of an array, whose zero key is the name of the modifier

["toTime","H:i:s Y-m-d"]

["trim"]

["ltrim"]

["rtrim"]

["upper"]

["lower"]

["ucfirts"]

["replace"," ","-"]

["substr",1,5]

["condition","Yes","No"]

["conditionSelfText","abc"]

["conditionSelfText","delivery_name"]

["regex","/test/","-"]

["replace,ab,bb","upper","sustr,1,2"]

prefix

Prefix dodany do wartości

Prefix added to the value

suffix

Suffix dodany do wartości

Suffix added to the value