Skip to content

Commit

Permalink
OP-412 - Added functionalities.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tomkalon committed Aug 9, 2024
1 parent a21b7aa commit 2434c7f
Show file tree
Hide file tree
Showing 7 changed files with 95 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Like what we do? Want to join us? Check out our job listings on our [career page
***

* [Overview](#overview)
* [Functionalities](doc/functionalities.md)
* [Support](#we-are-here-to-help)
* [Installation](#installation)
* [Testing](#testing)
Expand Down
94 changes: 94 additions & 0 deletions doc/functionalities.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# Functionalities

---
### Introduction

---
Poczta Polska is Poland's national postal operator,
which offers letter, parcel, and special delivery services both domestically and internationally.

The plug-in allows you to order postal services from the Poczta Polska Service with a click of the mouse, without having to fill in the data each time.

This plugin supports communication with the PocztaPolska API (Elektroniczny Nadawca wersja), including exporting shipping data
and creating ready-made labels to print directly from the order.

### Usage

---
#### Adding Shipping Gate

After installation, users can add the shipping method corresponding to the service provider
to which they want to export shipments.

<div align="center">
<img src="./images/shipping_method.png"/>
</div>
<br>

It then creates a new "shipping gateway" for the added shipping method.
When a customer selects this shipping method when ordering products, the order will be captured by the gateway.
<div align="center">
<img src="./images/shipping_gateway.png"/>
</div>
<br>

Selects the shipping method and completes the form fields accordingly.

<div align="center">
<img src="./images/shipping_gateway_details.png"/>
</div>
<br>

#### API options

It is possible to select:

<div align="center">
<img src="./images/shipping_gateway_details2.png"/>
</div>
<br>

Determine the payment page:
- Sender
- Recipient
- Third party

Payment method:
- Bank transfer
- Cash payment

Type of request:
- Create the shipment and order the courier
- Order courier
- Creating a shipment without restriction

Type of transport service:
- Domestic shipment
- Service Domestic 09
- Service Domestic 12
- Shipment Connect
- Shipment International

**_Shipment start hour_**:
Specifies the time from which the shipment is ready for collection by the courier

**_Shipment end hour_**:
Specifies the end time by which the courier can arrive to pick up the shipment.
After this hour, the shipment may no longer be available for pickup.

**_Pickup breaking hour_**:
Specifies the cut-off time by which the courier can come to pick up the shipment.
This is the hour after which the collection of the shipment will be postponed to the next business day.

<br>


#### Shipping Exports
Once the shipping method and shipping gateway for the shipping provider are created,
customer can use this shipping method during a checkout. When the order is placed,
user can now go to the 'Export shipping data' section from Sylius Admin Panel and export chosen shipments.

After exporting the shipment, it is possible to download the label for printing.
<div align="center">
<img src="./images/shipping_export.png"/>
</div>
Binary file added doc/images/shipping_export.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/images/shipping_gateway.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/images/shipping_gateway_details.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/images/shipping_gateway_details2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/images/shipping_method.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 2434c7f

Please sign in to comment.