Invia

Smake

API

per stampa (DTG) & Fullfillment

Stampa e invia prodotti con un semplice chiamata API

  • Ordina dal nostro catalogo - prezzi direttamente dai produttori.
  • Nessun intermediario
  • Prezzi all'ingrosso competitivi a partire da un pezzo.
  • Processo semplice ed economico tramite API - completamente integrata.
  • Dopo l'integrazione puoi accedere direttamemente a tutte le funzioni, tra cui spedizione white-label, controllo dell'ordine e della spedizione.

Primo passo per gli sviluppatori

Abbiamo tutto sotto controllo, dalla creazione dei prodotti agli ordini fino alla produzione.

Carica la foto

Carica l'anteprima del prodotto

Carica un'anteprima del prodotto finito. Utilizza questo per posizionare la decorazione sul prodotto.

Carica il motivo

Carica tutti i file stampa come PNG / JPG.

Documentazione - Carica la foto

Per lo sviluppatore

Carica direttamente i file dell'immagine come file binario. In risposta ricevi direttamente l'oggetto multimediale con l'ID necessario e ulteriori infomazioni.

Esempio di richiesta

POST /media
Content-Type: image/jpeg
Content-Length: 42840
                            

raw content
                            
Esempio di risposta

{
    "id": 1,
    "is_test": true,
    "file_name": "39b8196929f742e7bccab01a643b6524.jpeg",
    "size": 42840,
    "mime_type": "image/jpeg",
    "download_url": "https://api.smake.io/v2/media/1/download",
    "created_at": "2017-09-28T08:40:44+00:00",
    "updated_at": "2017-09-28T08:40:44+00:00"
}
                            

Progetta un prodotto

Trova un prodotto

Per progettare il tuo prodotto ti serve come prima cosa una variante di prodotto. La puoi selezionare dall'insieme dei prodotti.

Documentazione - Trova un prodotto
Realizza prodotto

Ora aggiungi la visualizzazione del prodotto desiderata, l'ID del file di anteprima e l'ID del motivo desiderato.

Documentazione - Realizza prodotto

Per lo sviluppatore

L'ID della variante prodotto progettata sarà necessaria nel prossimo passaggia dell'ordine.

Esempio di richiesta

POST /variants/1/design
                            

{
    "views": {
        "front": {
            "composite_media_id": 1,
            "customizations": [
                {
                    "type": "dtg",
                    "production_media_id": 2,
                    "dimension": {
                        "width": 100.55,
                        "height": 200.66
                    }
                },
                ...
            ]
        }

    }
}
                            
Esempio di risposta

{
    "id": 2,
    "is_test": true,
    "total": 259.98,
    "price": 218.47,
    "tax": 41.51,
    "tax_rate": 19,
    "code": null,
    "attributes": [
        {
            "name": "color",
            "value": "LightYellow"
        },
        {
            "name": "size",
            "value": "XL"
        }
    ],
    "media_id": 1094,
    "views": {
        ...
        "front": {
            "composite_media_id": 1,
            "customizations": [
                {
                    "type": "dtg",
                    "production_media_id": 2,
                    "preview_media_id": 3,
                    "dimension": {
                        "width": 100.55,
                        "height": 200.66
                    }
                },
            ]
        },
        ...
    },
    "created_at": "2017-09-28T14:48:05+00:00",
    "updated_at": "2017-09-28T14:48:05+00:00"
}
                            

Realizza un ordine

Prodotti

Aggiungi gli ID delle varianti di prodotti progettate nella quantità desiderita.

Documentazione - Prodotti
Indirizzo di spedizione

Aggiungi l'indirizzo di spedizione. Verrà utilizzato anche come indirizzo di fatturazione, salvo diversa indicazione.

Documentazione - Realizza un ordine

Per lo sviluppatore

Gli elementi dell'indirizzo di spedizione devono essere compilati in ogni parte. Questi dati sono necessari anche per determinare i costi di spedizione.

Esempio di richiesta

POST /checkouts
                            

{
    "email": "customer@example.com",
    "items": [
        {
            "variant_id": 1,
            "quantity": 1
        }
    ],
    "shipping_address": {
        "first_name": "John",
        "last_name": "Doe",
        "street1": "123 Main St",
        "zip": "12345",
        "city": "Anytown",
        "country_code": "DE",
        "province_code": "NW",
        "phone": "12345 67890",
        "email": "shipping@example.com"
    }
}
                            
Esempio di risposta

{
    "id": 1,
    "is_test": true,
    "external_identifier": null,
    "project_name": null,
    "state": "incompleted",
    "customer_locale": "en",
    "currency": "EUR",
    "total": 123.75,
    "subtotal": 103.99,
    "total_tax": 19.76,
    "total_items_price": 123.75,
    "shipping_line": [],
    "created_at": "2017-09-29T09:14:11+00:00",
    "updated_at": "2017-09-29T09:14:11+00:00",
    "cancelled_at": null,
    "items": [
        {
            "id": 75,
            "quantity": 1,
            "total": 123.75,
            "price": 103.99,
            "total_tax": 19.76,
            "tax_rate": 19,
            "variant": {
                "id": 2,
                ...
            },
            "created_at": "2017-09-29T09:14:11+00:00",
            "updated_at": "2017-09-29T09:14:11+00:00",
            "cancelled_at": null
        }
    ],
    "customer": {
        "id": 98,
        ...
    },
    "shipping_address": {
        "id": 190,
        ...
    },
    "billing_address": {
        "id": 191,
        ...
    },
    "whitelabel_address": null,
    "transactions": [],
    "fulfillments": [],
    "id_tags": []
}
                            

Calcola i costi di spedizione

I costi di spedizione vengono determinati in base alla dimensione, il peso, l'indirizzo di consegna dei fornitori di servizi di spedizione selezionati.

Documentazione - Calcola i costi di spedizione

Per lo sviluppatore

La gestione (handle) del metodo di consegna è necessarria nella fase successiva dell'ordine.

Esempio di richiesta

GET /checkouts/1/shipping-rates
                            
Esempio di risposta

{
    "data": [
        {
            "is_test": true,
            "handle": "pickup",
            "title": "Abholung",
            "price": 22
        }
    ],
    ...
}
                            

Imposta il metodo di consegna

Imposta il metodo di consegna desiderato in base alle possibili modalità di consegna determinate in precedenza.

Documentazione - Imposta il metodo di consegna

Per lo sviluppatore

Aggiorna l'elemento "shipping.handle" con "handle" desiderato dall'ultimo passaggio.

Esempio di richiesta

PUT /checkouts/1
                            

{
    "shipping": {
        "handle": "pickup"
    }
}
                            
Esempio di risposta

{
    ...
    "shipping_line": {
        "title": "Pickup",
        "price": 22.06,
        "total": 26.25,
        "tax": 4.19
    },
    ...
}
                            

Completa l'ordine

Metodo di pagamento

Al momento la fattura è l'unico metodo di pagamento disponibile.

Documentazione - Completa l'ordine

Per lo sviluppatore

Aggiorna l'elemento "payment.handle" con "fattura". L'importo totale viene calcolato in base al prezzo del prodotto e le spese di consegna.

Esempio di richiesta

POST /checkouts/1/complete
                            

{
    "payment": {
      "handle": "invoice",
      "amount": 150.0
    }
}
                            
Esempio di risposta

{
    "id": 1,
    "is_test": true,
    "external_identifier": null,
    "project_name": "et",
    "state": "delivered",
    "customer_locale": "en",
    "currency": "EUR",
    "total": 87.76,
    "subtotal": 86.63,
    "total_tax": 1.13,
    "total_items_price": 82.98,
    "shipping_line": {
        "title": "Pickup",
        "price": 4.47,
        "total": 4.78,
        "tax": 0.31
    },
    "created_at": "2017-09-27T10:10:59+00:00",
    "updated_at": "2017-09-27T10:11:03+00:00",
    "cancelled_at": null,
    "items": [
        {
            "id": 1,
            "quantity": 4,
            "total": 82.98,
            "price": 20.54,
            "total_tax": 0.82,
            "tax_rate": 1,
            "variant": {
                "id": 27,
                ...
            },
            "created_at": "2017-09-27T10:10:59+00:00",
            "updated_at": "2017-09-27T10:10:59+00:00",
            "cancelled_at": null
        }
    ],
    "customer": {
        "id": 40,
        ...
    },
    "shipping_address": {
        "id": 45,
        ...
    },
    "billing_address": {
        "id": 44,
        ...
    },
    "whitelabel_address": null,
    "transactions": [
        ...
    ],
    "fulfillments": [
        ...
    ],
    "id_tags": [
        ...
    ]
}