{"id":29348,"date":"2024-01-16T11:11:32","date_gmt":"2024-01-16T11:11:32","guid":{"rendered":"https:\/\/kb.sambapos.com\/?p=29348"},"modified":"2024-01-16T13:13:01","modified_gmt":"2024-01-16T13:13:01","slug":"4-48-defining-multiple-delivery-addresses-for-customers","status":"publish","type":"post","link":"https:\/\/kb.sambapos.com\/en\/4-48-defining-multiple-delivery-addresses-for-customers\/","title":{"rendered":"4.48. Defining Multiple Delivery Addresses for Customers"},"content":{"rendered":"

In this document it will be explianed how to define multiple delivery addresses for customers.<\/p>\n

How it Works;<\/strong><\/p>\n

\"\"<\/p>\n

1. Editing Customers Entity Type<\/strong><\/span><\/h3>\n

Main Menu > Manage > Entities > Entity Types > Customers > Custom Fileds > <\/strong>Here, click on Add Custom Field <\/strong>and add as many new custom fields as customer’s address quantity.<\/p>\n

\"\"<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

2. Adding Ticket Tag<\/strong><\/span><\/h3>\n

Main Menu > Manage > Tickets > Ticket Tags > <\/strong>Here, click on Add Ticket Tag.<\/strong><\/p>\n

General Settings Section;<\/strong><\/p>\n

\"\"<\/p>\n

Ticket Tag Name:<\/strong> Delivery Addresses<\/p>\n

Free Tagging:<\/strong> Must be selected<\/p>\n

Mappings Section;<\/strong><\/p>\n

You can leave this field blank.<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

3. Editing Ticket Template<\/strong><\/span><\/h3>\n

Main Menu > Manage > Printing > Printer Templates Ticket Template <\/strong>> <\/strong>Here, copy the below code group and paste it under the [ENTITIES:Customer]<\/strong> as shown in the image.<\/p>\n

<J11>Address:{TICKET TAG:Delivery Addresses}<\/code><\/p>\n

\"\"<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

4. Adding Actions<\/strong><\/span><\/h3>\n

4.1. Adding MA-Update Ticket Tag Action<\/strong><\/p>\n

Main Menu > Manage > Automation > Actions ><\/strong> Here, click on Add Action<\/strong>.<\/p>\n

\"\"<\/p>\n

Action Name:<\/strong> MA-Update Ticket Tag<\/p>\n

Action Type:<\/strong> Update Ticket Tag<\/p>\n

Parameters:<\/strong><\/p>\n

Tag Name:<\/strong> Delivery Addresses<\/p>\n

Tag Value:<\/strong> [:Addresses]<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

4.2. Adding MA-Show Message Action<\/strong><\/p>\n

Main Menu > Manage > Automation > Actions ><\/strong> Here, click on Add Action<\/strong>.<\/p>\n

\"\"<\/p>\n

Action Name:<\/strong> MA-Show Message<\/p>\n

Action Type:<\/strong> Show Message<\/p>\n

Parameters:<\/strong><\/p>\n

Message:<\/strong> [:Message]<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

4.3. Adding MA-Update Entity Note Action<\/strong><\/p>\n

Main Menu > Manage > Automation > Actions ><\/strong> Here, click on Add Action<\/strong>.<\/p>\n

\"\"<\/p>\n

Action Name:<\/strong> MA-Update Entity Note<\/p>\n

Action Type:<\/strong> Update Entity Note<\/p>\n

Parameters:<\/strong><\/p>\n

Entity Name:<\/strong> [:Customer Name]<\/p>\n

Entity Type:<\/strong> Customers<\/p>\n

Name:<\/strong> [:AddressName]<\/p>\n

Note:<\/strong> [:Addresses]<\/p>\n

Color:<\/strong> [:Color]<\/p>\n

Display Once:<\/strong> True<\/p>\n

Automation Command:<\/strong> MA-Set Delivery Addresses<\/p>\n

Automation Command Value:<\/strong> [:AddressNumbers]<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

4.4. Adding MA-Update Entity Data Action<\/strong><\/p>\n

Main Menu > Manage > Automation > Actions ><\/strong> Here, click on Add Action<\/strong>.<\/p>\n

\"\"<\/p>\n

Action Name:<\/strong> MA-Update Entity Data<\/p>\n

Action Type:<\/strong> Update Entity Data<\/p>\n

Parameters:<\/strong><\/p>\n

Entity Type Name:<\/strong> Customers<\/p>\n

Entity Name:<\/strong> [:Customer Name]<\/p>\n

Field Name:<\/strong> Delivery Addresses<\/p>\n

Field Value:<\/strong> [:Delivery Addresses]<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

5.Adding Rules<\/strong><\/span><\/h3>\n

5.1. Adding MA-Set Address Notes Rule<\/strong><\/p>\n

Main Menu > Manage > Automation > Rules ><\/strong> Here, click on Add Rule<\/strong>.<\/p>\n

General Settings Section;<\/strong><\/p>\n

\"\"<\/p>\n

Rule Name:<\/strong> MA-Set Address Notes<\/p>\n

Event Name:<\/strong> Ticket Entity Changed<\/p>\n

Execute Rule if:<\/strong> Matches<\/p>\n

Add Custom Constraint<\/strong><\/p>\n

Entity Type Name|Equals|Customers<\/p>\n

Select Action:<\/strong><\/p>\n

Action-1: MA-Update Entity Note<\/strong><\/p>\n

Constraint:<\/strong> '{ENTITY DATA:Customer:Address-1}' != \"<\/code><\/p>\n

Customer Name:<\/strong> {ENTITY NAME:Customer}<\/p>\n

AdressName:<\/strong> Address-1<\/p>\n

Addresses: {ENTITY DATA:Customer:Address-1}<\/strong><\/p>\n

Color:<\/strong> CornflowerBlue<\/p>\n

AddressNumbers:<\/strong> Address-1<\/p>\n

On the Action Adding Screen <\/strong>right click on mouse and select Display All Values <\/strong>so you can add the same action multiple times.<\/p>\n

Action-2: MA-Update Entity Note<\/strong><\/p>\n

Constraint:<\/strong> '{ENTITY DATA:Customer:Address-2}' != \"<\/code><\/p>\n

Customer Name:<\/strong> {ENTITY NAME:Customer}<\/p>\n

AdressName:<\/strong> Address-2<\/p>\n

Addresses: {ENTITY DATA:Customer:Address-2}<\/strong><\/p>\n

Color:<\/strong> CornflowerBlue<\/p>\n

AddressNumbers:<\/strong> Address-2<\/p>\n

On the Action Adding Screen <\/strong>right click on mouse and select Display All Values <\/strong>so you can add the same action multiple times.<\/p>\n

Action-3: MA-Update Entity Note<\/strong><\/p>\n

Constraint:<\/strong> '{ENTITY DATA:Customer:Address-3}' != \"<\/code><\/p>\n

Customer Name:<\/strong> {ENTITY NAME:Customer}<\/p>\n

AdressName:<\/strong> Address-3<\/p>\n

Addresses: {ENTITY DATA:Customer:Address-3}<\/strong><\/p>\n

Color:<\/strong> CornflowerBlue<\/p>\n

AddressNumbers:<\/strong> Address-3<\/p>\n

Mappings Section;<\/strong><\/p>\n

Here, add a line by clicking on Add<\/strong> button and determine Ticket Type<\/strong> according to your Delivery Ticket Type <\/strong>name (in the example it’s Delivery Ticket). So that this configuration will only work for Delivery Orders not for Table\/Dine In orders.<\/p>\n

\"\"<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n

5.2. Adding MA-Set Delivery Addresses Rule<\/strong><\/p>\n

Main Menu > Manage > Automation > Rules ><\/strong> Here, click on Add Rule<\/strong>.<\/p>\n

General Settings Section;<\/strong><\/p>\n

\"\"<\/p>\n

Rule Name:<\/strong> MA-Set Delivery Addresses<\/p>\n

Event Name:<\/strong> Automation Command Executed<\/p>\n

Execute Rule if:<\/strong> Matches<\/p>\n

Add Custom Constraint<\/strong><\/p>\n

Automation Command Name|Equals|MA-Set Delivery Addresses<\/p>\n

Select Action:<\/strong><\/p>\n

Action-1: MA-Show Message<\/strong><\/p>\n

Message:\u00a0<\/b>Address for {ENTITY NAME:Customer}:\\r{ENTITY NOTE:Customer:[:CommandValue]}<\/p>\n

Action-2: MA-Update Entity Data<\/strong><\/p>\n

Customer Name:<\/strong> {ENTITY NAME:Customer}<\/p>\n

Delivery Adresses:<\/strong> {ENTITY NOTE:Customer:[:CommandValue]}<\/p>\n

Addresses: {ENTITY DATA:Customer:Address-2}<\/strong><\/p>\n

Action-3: MA-Update Ticket Tag<\/strong><\/p>\n

Addresses:\u00a0<\/strong>{ENTITY NOTE:Customer:[:CommandValue]}<\/p>\n

Action-4: MA-Update Entity Note<\/strong><\/p>\n

Customer Name:<\/strong>\u00a0{ENTITY NAME:Customer}<\/p>\n

AddressName:\u00a0<\/strong>[:CommandValue]<\/p>\n

Addresses:\u00a0<\/strong>{ENTITY NOTE:Customer:[:CommandValue]}<\/p>\n

Color:<\/strong> Red<\/p>\n

AddressNumbers:<\/strong> [:CommandValue]<\/p>\n

Mappings Section;<\/strong><\/p>\n

Here, add a line by clicking on Add<\/strong> button and determine Ticket Type<\/strong> according to your Delivery Ticket Type <\/strong>name (in the example it’s Delivery Ticket). So that this configuration will only work for Delivery Orders not for Table\/Dine In orders.<\/p>\n

\"\"<\/p>\n

After completing necessary editings, click on\u00a0Save<\/strong>\u00a0button.<\/p>\n","protected":false},"excerpt":{"rendered":"

In this document it will be explianed how to define multiple delivery addresses for customers. How it Works; 1. Editing Customers Entity Type Main Menu > Manage > Entities > Entity Types > Customers > Custom Fileds > Here, click on Add Custom Field and add as many new custom fields as customer’s address quantity. […]<\/p>\n","protected":false},"author":11,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[],"class_list":["post-29348","post","type-post","status-publish","format-standard","hentry","category-customization"],"_links":{"self":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/29348","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/comments?post=29348"}],"version-history":[{"count":5,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/29348\/revisions"}],"predecessor-version":[{"id":29379,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/29348\/revisions\/29379"}],"wp:attachment":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/media?parent=29348"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/categories?post=29348"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/tags?post=29348"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}