> ## Documentation Index
> Fetch the complete documentation index at: https://stripe-sendcloud-docs.vinaka-apps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the app

> Operational overview of sync, manual actions, and status tracking.

This page gives a quick operational overview. For detailed steps, go to [App manual](/using-the-app/app-manual).

## Sync modes

### Automatic sync

Automatic sync is webhook-driven:

1. Stripe sends a configured invoice event.
2. The app validates the webhook signature.
3. The app resolves invoice data and order items.
4. The app sends the order payload to Sendcloud.
5. A sync reference is stored to prevent duplicates.

### Manual sync

Manual sync is user-driven from the Stripe invoice detail page:

1. User clicks **Create order in Sendcloud**.
2. The app checks if the invoice already has a successful sync reference.
3. If not synced, the app creates the Sendcloud order.
4. The app stores sync status and references.

### Customer order history

From Stripe customer detail pages, the app shows synced Sendcloud orders linked to that customer, including invoice reference, Sendcloud order reference, and latest shipment/tracking details when available.

## Duplicate prevention

The app checks existing sync references by invoice identity before creating a new order. If already synced, it returns an "already exists" style result instead of creating duplicate orders.

## Shipment visibility

After Sendcloud sends update webhooks, the app can display:

* Sendcloud order reference,
* parcel or shipment reference,
* tracking number and tracking URL,
* latest update status.