Karrio

What's Changed

- Integrate 2FA for login
- Introduce package level options (for package insurance/coverage)
- Add support for audit logging (`insiders only`)
- Persist carrier requests logs for the foundation of advanced debug mode
- Data imports foundation for batch tracking data import (`insiders only`)
- Deprecate `test_mode` flags in favour of `API Keys` in a test or live modes
- Improve API queries using SQL indexes (API logs, API events, Shipments, Orders...)
- Improve and standardized error response

What's New

- Distinguish carrier hubs extensions from regular extensions
- Fix UPS shipment cancellation API call (VOID) (https://github.com/karrioapi/karrio-dashboard/issues/190)
- Add GraphQL mutations for webhooks
- Add GraphQL mutations for orders
- Beta AmazonMws carrier integration
- Improve DHL Universal tracking extension response parsing and edge cases from all supported DHL services.
- Set fallback values for DHL express extension shipment commodity codes
- Set fallback values for FedEx extension shipment address phone numbers.
- Add webhook for order update
- Reduce noise in carrier request logs (remove duplicates and make logging optional on Serializable abstraction)
- Introduce a data module (`insiders only`) for data export (csv, json, xls...). Currently, support exporting orders and shipments

Breaking changes

- Uniformize collection APIs filters for GraphQL and REST APIs
- Deprecate noisy properties from rates

**Before**:
JSON
{
"id": "string",
"object_type": "rate",
"carrier_name": "string",
"carrier_id": "string",
"currency": "string",
"service": "string",
"discount": 0,
"base_charge": 0,
"total_charge": 0,
"duties_and_taxes": 0,
"transit_days": 0,
"extra_charges": [ ],
"meta": { },
"test_mode": true
}

**Now**:
JSON
{
"id": "string",
"object_type": "rate",
"carrier_name": "string",
"carrier_id": "string",
"currency": "string",
"service": "string",
"total_charge": 0,
"transit_days": 0,
"extra_charges": [ ],
"meta": { },
"test_mode": true
}

What's New

- Rebrand Purplship -> Karrio
- Improve document management modules (enrich shipment and order template contexts).
- Introduce `order.order_date` and `line_item.unfulfilled_quantity` properties for better handling of partial orders.
- Improve custom carrier label management
- Provide default order and shipment dates
- Fix tracker `in_transit` status inconsistency
- Introduce Sentry support for Karrio dashboard error tracking and APM

Road to cloud beta

- Consolidate email flows for operations that require confirmations
- Consolidate organization and team management (`insiders`)
- Organization members listing and invitation
- Organization ownership transfer
- Organization creation
- Setup foundations for oauth2 and apps integration (beta) (`insiders`)
- Implement Webhook secret header for event origin signature validation
- Integrate One-call shipment label purchase
- Automate incremental tracking_number generation for customs carrier labels
- Order management update (`insiders`)
- Introduce `shipping_from` for orginin address prefill
- Rename `shipping_address` to `shipping_to`


Breaking changes

- **The GraphQL API queries and mutations have been enhanced and some renamed for consistency.**
**We highly recommend using the same version on the server and dashboard**

- **Introduce `docs: Documents = JStruct[Documents, REQUIRED]` to `ShipmentDetails`**

_The implied the removal of the `label: str` field from the root of `ShipmentDetails` to `ShipmentDetails.docs.label`_

Proxy API `POST /v1/proxy/shiping` now returns as `docs` object with `label` base64 string and optionally an `invoice` base64 string

API `Shipment` object now returns
- `label_url`: URL to the purchase shipment label
- `invoice_url`: URL to the purchase shipment invoice when supported

API `Shipment` deprecated data
- `label` field has been deprecated and removed in order to optimize shipments database queries and size
- `shipment.meta.invoice` field has been deprecated and removed for optimization as well

**As a result of this change, shipments requests are less heavy and faster**


Bugs

- Inconsistent Charfield validation caused validity pre-request and failure to persist carrier API changes to the database.

Docker builds

Current release `2022.2` - `danh91.docker.scarf.sh/purplship/server:2022.2`

danh91.docker.scarf.sh/purplship/server:2022.1.4

What's New

- Apply Canadian postal code pre-validation patch
- Improve Trackers API to accept tracking numbers without a record as pending
- Retrieved `estimated_delivery` during tracking for all supporting carriers
- Ensure FedEx dimension definitions only when `packaging_type` is `your_packaging`
- Introduced Persisted events
- Improve FedEx multi-piece shipment compiling all package labels together
- Introduce DHL Parcel Poland `sponsored` integration (https://github.com/purplship/purplship/issues/166)
- Introduce the purplship universal carrier service level definition
- Apply (2121.7.7) database query perf improvements
- Introduce `TRACKING_PULSE` env var to setup background trackers update interval seconds
- Introduce `BASE_PATH` env var to set up runtime base path for the API (e.g: `/api` for `example.com/api` deployment)
- Introduce advanced query filters for shipments, logs, events, trackers and webhooks

Bugs

- Fix Webhooks notification scope only to related account and organization