API Temel URI Bitiş Noktası
Tüm API çağrılarımız için bitiş noktası şöyledir: https://app.prodsmart.com/
Kimlik Doğrulama
Prodsmart API basit bir belirteç yetkilendirmesi kullanır. Önce yeni bir belirteç oluşturursunuz (veya mevcut bir belirteci alırsınız). Belirtecinizi aldıktan sonra, belirtecin kapsamındaki diğer kaynaklara erişmek için kullanabilirsiniz.
Kimlik doğrulama belirteciniz 2 saat sürer ve ardından API kimlik bilgilerinizle yeni bir tane istemeniz gerekir.
Medya Türleri
İleti gövdesine sahip istekler, kaynak durumlarını ayarlamak veya güncelleştirmek için düz JSON kullanır.
Hata Durumları
Ortak HTTP Yanıt Durum Kodları kullanılır.
Geçersiz Json
“Geçersiz JSON” ifadesini içeren bir yanıt alırsanız lütfen JSONLint’te kullandığınız json yükünü doğrulayın.
Hız Sınırı
API istekleri, şirket başına dakikada 120 istekle sınırlıdır. Sınır aşıldıktan sonra, sonraki istekler HTTP Durum Kodu 429 Çok Fazla İstek şeklinde bir yanıt alır.
Ayrıca bir başlık, isteği yeniden denemeden önce kaç saniye beklemeniz gerektiğini gösterir:
Retry-After: <delay-seconds>
Hız sınırıyla başa çıkmak için en iyi uygulamalar:
Yanıtların kısıtlanmasına yol açabilecek kullanım artışlarını önlemek için istekleri zamana eşit şekilde dağıtın
İsteğin ne zaman yeniden denenebileceğini bilmek için Yeniden Dene-Sonra bilgilerini kullanan bir mantık geliştirin
Gereksiz entegrasyonlarınızın paralel olarak çalışmadığından emin olun çünkü tüm entegrasyonlar sınıra dahil edilecektir.
Tarih Formatı
API tarih alanları ISO 8601 standardına göre belirlenir:
YYYY-AA-GGTss:dd:ssZ
Bu formatta T harfi gerekli bir sınırlayıcı olarak işlev görürken, Z gerekirse bir saat dilimini gösterecektir. Z kullanılmadığında, tarihe uygulanan saat dilimi Prodsmart şirketinizde ayarlananla aynıdır. Z, 0 ile dengelendiği için Sıfır saat dilimini temsil eder.
Kullanım örneği:
Kullanılan saat UTC’den bir saat ileriyse bölge belirleyicisi “+01:00”, “+0100” veya kısaca “+01” olmalıdır.
Bir şirketin saat dilimi -05:00 olarak ayarlanmışsa ve gönderilen tarih 2020-07-20T09:15:15Z formatında ise tarih Prodsmart’ta şu şekilde görüntülenecektir: 07/20/2020 - 04:15:15
Gönderilen format: 2020-07-20T09:15:15 ise tarih Prodsmart’ta şu şekilde görüntülenecektir: 07/20/2020 - 09:15:15 (-05:00 saat dilimiyle), yani Kullanıcı -04:00 olarak ayarlanmış bir saat dilimine sahipse bunu şu şekilde görecektir: 07/20/2020 - 10:15:15
Ortak ERP entegrasyonları
ERP entegrasyonları için olağan senaryolar esas olarak Üretim Siparişleri, Stoklar ve Ürün kataloğunun senkronizasyonudur.
Üretim Siparişleri
ERP tarafında bir üretim siparişi oluşturulduğunda ERP, Üretim Siparişi Oluşturma Hizmetini kullanarak üretim siparişi verilerini JSON formatında Prodsmat API’sına göndermelidir. Prodsmart’ta bir üretim siparişi oluşturulduğunda veya güncellendiğinde ERP tarafının güncellenmesi gerekiyorsa iki olasılık vardır: ERP ile dışarıdan bağlantı kurulabilir ve bu durumda Prodsmart’ta web kancaları kurmak mümkündür ve web kancaları Prodsmart tarafında Üretim Siparişlerinin oluşturulması, güncellenmesi ve silinmesi için kullanılır. ERP ile dışarıdan bağlantı kurulamıyorsa ERP’nin değişiklikleri tespit etmek için Üretim Siparişleri Listesi Hizmetini aktif olarak yoklaması gerekir.
Stoklar
Genellikle ERP (veya WMS) stokların ana yöneticisidir, bu nedenle ERP/WMS’nin bir ürünün mevcut stokunu belirli bir miktara güncellemesini sağlayan bir hizmet (Ürün stokunu güncelleme) sağlıyoruz. Bazen ERP/WMS, üretim siparişlerindeki değişiklikleri izleyerek veya web kancalarını veya mevcut bir stok web hizmetini (talep üzerine) kullanarak üretim stoku değişikliklerinden haberdar edilebilir.
Ürünler
Çok sık olmamakla birlikte ürün kataloğu da senkronize edilir. Bu durumda ERP her zaman ana konumdadır ve Ürün Oluşturma hizmetini kullanarak Ürünler ve İşlemler oluşturabilir.
Web kancaları
Uygulamadaki entegrasyonlar menüsünden üretim siparişi olayları için web kancaları kullanılabilir. Bu özelliği kullanmak için lütfen takip etmek istediğiniz bildirim olaylarıyla birlikte bitiş noktası URL geri aramayı ekleyin. Sistemimizde olaylar meydana gelir gelmez web kancası bildirimlerini hızlı bir şekilde göndermeye çalışıyoruz. Eş zamanlı olarak değiştirilen çok sayıda üretim siparişiniz varsa kısa bir süre içinde çok sayıda bildirim alabilirsiniz. Mevcut durumda herhangi bir yeniden deneme işlemi desteklenmiyor.
Başlıklar
Web kancası başlıkları
x-prodsmart-topic: "productionOrder/create"x-prodsmart-hmac-sha256: "c938fe31379c0d89b37468e1cae9e3aab2d56834"x-prodsmart-api-version: "1"x-prodsmart-webhook-uuid: "91cb972d-b476-4936-947c-4be471b9da5b"x-prodsmart-triggered-at: "2023-08-29T20:39:46.142Z"
Not:
x-prodsmart-topic - Web kancasının konusunu tanımlayın
x-prodsmart-hmac-sha256 -Web kancasının kaynağını doğrulamak için kullanılır
x-prodsmart-api-version -Web kancasını göndermek için kullanılan API sürümü
x-prodsmart-webhook-uuid - Benzersiz web kancasını tanımlayın
x-prodsmart-triggered-at - Web kancasının tetiklendiği zaman
Web kancası nasıl doğrulanır?
200 durum koduyla yanıt vermeden önce web kancasının Prodsmart’tan geldiğini doğrulamak çok önemlidir. Bu doğrulama bir imzanın programlanmasıyla gerçekleştirilir.
Her web kancası isteği, base64 formatında kodlanmış x-prodsmart-hmac-sha1 adlı belirli bir başlıkla birlikte gelir. Bu başlık, hem API parolası hem de web kancası isteğine dahil edilen veriler kullanılarak oluşturulur.
Web kancasının orijinalliğini doğrulamak için aynı API gizli anahtarını ve sağlanan verileri kullanarak imzayı kendinizin programlaması gerekir.
Programlanan imzayı aldıktan sonra, gelen web kancası isteğinin x-prodsmart-hmac-sha1 başlığında bulunan değerle karşılaştırın.
Programlanan imza x-prodsmart-hmac-sha1 başlığındaki değerle eşleşiyorsa web kancasının gerçekten Prodsmart’tan gönderildiğinden emin olabilir, 200 durum koduyla yanıt vermeye devam edebilirsiniz.
Üretim Siparişleri
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "products": [ { "product": "V23076", "quantity-ordered": 3500, "observations": "", "quantity-produced": 700 } ], "code": "Test Production Order", "shipping": { "code": "shipping 45" }, "serial-number": "", "description": "", "start-date": "2023-04-20T09:15:15Z", "due-date": "2023-05-16T17:15:15Z", "workers-assigned": [ { "number": 120 }, { "number": 11 }, { "number": 10 }, { "number": 1 } ], "ended": false, "machines": [ { "code": "A32" }, { "code": "F1" } ], "pieces-by-box": 20, "status": "onschedule", "running-status": "started", "notes": "", "id": 1}
Not: Üretim siparişi silindiğinde çalışma durumu da silinir.
Giriş/Çıkış Saati Cihazı
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 932015, "date": "2022-05-19T14:35:30.000+01:00", "notification": "punchClock_created", "worker": { "number": 0 }, "entry": 1}
giriş olası değerleri:
1 - Giriş
0 - Çıkış
bildirim olası değerleri:
giriş/çıkışSaati_oluşturuldu
giriş/çıkışSaati_güncellendi
giriş/çıkışSaati_silindi
Nakliye Envanter Hareketi
Nakliye envanteri hareketi oluşturuldu/güncellendi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
[{ "product": { "id": 222, "code": "product-code", "uom": "uom" }, "lot": { "code": "lot-code", "expiration-date": "lot-expiration-date", "supplier-lot": "supplier-lot-name" }, "date": "2022-02-21T00:00:00Z", "quantity": 10.0, "stock-type": "out", "comment": "comment", "warehouse-location": { "id": 333, "code": "warehouse-location-code", "warehouse": { "id": 444, "code": "warehouse-code" } }, "sales-order": { "id": 555, "code": "sales-order-code", "client": { "id": 777, "code": "client-code" }, "parameters": [{ "name": "parameterX", "value": "valueX" }] }, "shipping": { "id": 666, "code": "shipping-code" }, "worker": { "id": 333, "number": 0, "name": "worker-name" }}]
bildirim olası değerleri:
nakliye_envanter_hareketi_oluşturuldu
nakliye_envanter_hareketi_güncellendi
Nakliye envanter hareketi silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 111}
bildirim olası değerleri:
nakliye_envanter_hareketi_silindi
Envanter Hareketi Alımı
Oluşturulan/güncellenen envanter hareketini alma
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
[{ "product": { "id": 222, "code": "product-code", "uom": "uom" }, "lot": { "code": "lot-code", "expiration-date": "lot-expiration-date", "supplier-lot": "supplier-lot-name" }, "date": "2022-02-21T00:00:00Z", "quantity": 10.0, "stock-type": "in", "comment": "comment", "warehouse-location": { "id": 333, "code": "warehouse-location-code", "warehouse": { "id": 444, "code": "warehouse-code" } }, "purchase-order": { "id": 555, "code": "purchase-order-code", "supplier": "supplier-code", "parameters": [{ "name": "parameterX", "value": "valueX" }] }, "receiving": { "id": 666, "code": "receiving-code" }, "worker": { "id": 333, "number": 0, "name": "worker-name" }}]
bildirim olası değerleri:
envanter_hareketi_alımı_oluşturuldu
envanter_hareketi_alımı_güncellendi
Envanter hareketi alımı silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 111}
bildirim olası değerleri:
envanter_hareketi_alımı_silindi
Dahili Envanter Hareketi
Dahili envanter hareketi oluşturuldu/güncellendi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
[{ "product": { "id": 222, "code": "product-code", "uom": "uom" }, "lot": { "code": "lot-code", "expiration-date": "lot-expiration-date", "supplier-lot": "supplier-lot-name" }, "date": "2022-02-21T00:00:00Z", "quantity": 10.0, "stock-type": "in", "comment": "comment", "warehouse-location": { "id": 333, "code": "warehouse-location-code", "warehouse": { "id": 444, "code": "warehouse-code" } }, "worker": { "id": 333, "number": 0, "name": "worker-name" }}]
bildirim olası değerleri:
dahili_envanter_hareketi_oluşturuldu
dahili_envanter_hareketi_güncellendi
Dahili envanter hareketi silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 111}
bildirim olası değerleri:
dahili_envanter_hareketi_silindi
Malzeme Hazırlama Hareketi
Malzeme hazırlama oluşturuldu/güncellendi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
[{ "product": { "id": 222, "code": "product-code", "uom": "uom" }, "production-order": { "id": 333, "code": "production-order-code" }, "lot": { "code": "lot-code", "expiration-date": "lot-expiration-date", "supplier-lot": "supplier-lot-name" }, "date": "2022-02-21T00:00:00Z", "quantity": 10.0, "warehouse-location": { "id": 333, "code": "warehouse-location-code", "warehouse": { "id": 444, "code": "warehouse-code" } }, "worker": { "id": 333, "number": 0, "name": "worker-name" }}]
bildirim olası değerleri:
malzeme_hazırlama_oluşturuldu
malzeme_hazırlama_güncellendi
Malzeme hazırlama silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 111}
bildirim olası değerleri:
malzeme_hazırlama_silindi
Lot
Lot oluşturuldu/güncellendi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
[{ "code": "lot-code", "creation-date": "2022-02-21T00:00:00Z", "expiration-date": "2022-02-21T00:00:00Z", "supplier-lot": "supplier-lot-name", "product": { "id": 222, "code": "product-code", "uom": "uom" }}]
bildirim olası değerleri:
lot_oluşturuldu
lot_güncellendi
Lot silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 111}
bildirim olası değerleri:
lot_silindi
Çalışmama Süresi
ÇalışmamaSüresi oluşturuldu/güncellendi/silindi
İstek (uygulama/json)
Yöntem: GÖNDER
Gövde
{ "id": 1, "start-time": "2000-01-01T00:00:00.000+01:00", "end-time": "2099-12-31T23:59:59.999+01:00", "started-by": {}, "closed-by": { "number": 0 }, "workers": [ { "number": 0 } ], "machines": [], "product": "", "production-order": "", "checked-out": true, "downtime-type": "downtime1 type", "time-spent": "08:00:00", "event-type": "downTime_created"}
bildirim olası değerleri:
çalışmamaSüresi_oluşturuldu
çalışmamaSüresi_güncellendi
çalışmamaSüresi_silindi
Bilgilendirme Kanallarında Değişiklik
Herhangi bir nedenle web kancalarını kullanamıyorsanız şu anda son 24 saat içinde meydana gelen değişiklikleri depolayacak bir değişiklik yığını olarak veya değişiklikleri sağladığımız web hizmeti aracılığıyla en son talep edilenden itibaren bir alternatif sunuyoruz. Bu özelliği kullanmak için entegrasyonlar menüsünden (https://app.prodsmart.com/admin/integrations) kanal oluşturmanız gerekmektedir. Kuruluş başına en fazla 3 kanal oluşturabilirsiniz.
6 tür Değişiklik Kanalı vardır:
ÇALIŞMAMA_SÜRESİ
ÜRÜN
ÜRETİM
ÜRETİM_SİPARİŞİ
GİRİŞ/ÇIKIŞ_SAATİ
STOK
Değişiklikleri al
AL /api/changes/{channel}{?access_token}
Bu hizmeti çağırırken oluşturuldukları/güncellendikleri/silindikleri veya durumları değiştiği için değişen varlıkların bir listesini alırsınız. Varlıkların geçerli durumunu içeren (en eski değişikliklerden en yeniye doğru sıralanmış) ve hizmet çağrısı başına en fazla 25 olacak şekilde bir dizi alırsınız. Hizmetten aldığınız varlıklar yığından kaldırılır (yeni güncelleştirmeleri olana kadar). Herhangi bir değişiklik yoksa hizmet boş bir dizi (“[]”) verir.
Örnek URI
GET /api/changes/channel?access_token=
URI Parametreleri
URI Parametreleri
kanal
dize (gerekli)
erişilecek kanal
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
işçiler
boole (isteğe bağlı)
Üretim Siparişleri kanal yanıtında işçi listesini göster
İstek
İstek
Content-Type: application/json
ÇALIŞMAMA SÜRELERİ
[ { "id": 1435048, "start-time": "2022-04-22T14:47:00.000+01:00", "end-time": "2022-04-23T00:00:00.000+01:00", "started-by": {}, "closed-by": { "number": 1 }, "workers": [ { "number": 1 } ], "machines": [], "product": "", "production-order": "", "checked-out": true, "downtime-type": "Maintenance", "time-spent": "09:13:00", "event-type": "downTime_deleted", }]
Not: Olay türü alanı yalnızca bir Çalışmama Süresi silindiğinde bulunur.
ÜRETİM SİPARİŞLERİ
[ { "products": [ { "product": "RN2", "quantity-ordered": 30.0, "observations": "", "quantity-produced": 0.0 } ], "code": "Production Order 123", "description": "", "shipping": {}, "start-date": "2022-04-21T00:00:00.000+01:00", "due-date": "2022-04-28T00:00:00.000+01:00", "ended": false, "machines": [], "notes": "", "is-active": true, "running-status": "notstarted", "status": "onschedule", "material-staging-complete": false, "id": 1379919 }]
Not: Bir Üretim Siparişi silindiğinde çalışma durumu alanı silinmiş değerine sahip olacaktır.
ÜRÜNLER
[ { "code": "V23076", "name": "V23076", "observations": "", "section": null, "unit-cost": null, "unit-price": null, "families": [], "operations": [], "components": [], "custom-fields": [], "notification": null, "serializable": null, "shipping-package-types": [], "external-stock": null, "stock-max": null, "min-quantity-reorder": null, "quantity-multiple": null, "scrap-allowance": null, "shelf-life": null, "parameters": [] }]
Not: Bildirim alanı, bir Ürün silindiğinde ürün_silindi değerine sahip olacaktır.
ÜRETİM KAYITLARI
[ { "production-order": { "code": "P1 - Week 14", "id": 3641 }, "operation": { "code": "CUT3", "product": "P1" }, "worker": { "number": 6 }, "machine": { "code": "WJC" }, "quantity": 0.0, "checked-out": false, "produced-waste": [], "consumptions": [], "total-time-factor": 1.0, "rework": false, "work-time": "00H00m00s", "start-time": "2022-04-22T14:43:00.000+01:00", "end-time": "2022-04-22T14:43:00.000+01:00", "status": "deleted", "show-check-in-checklist-and-c-f": false, "id": 12952533 }]
Not: Durum alanı yalnızca bir Üretim Kaydı silindiğinde görünür.
GİRİŞ/ÇIKIŞ SAATİ CİHAZLARI
[ { "id": 932015, "date": "2022-05-19T14:35:30.000+01:00", "notification": "punchClock_deleted", "worker": { "number": 0 }, "entry": 1 }]
Not: Bildirim alanı yalnızca bir Giriş/Çıkış Saati girişi silindiğinde görünür.
STOK
[ { "product-code": "P1", "stock": 2395.0, "lot": [ { "code": "Lot 0086", "stock": 500.0 } ] }]
Tedarikçi
Prodsmart API’nın tedarikçi kaynakları.
TEDARİKÇİ
Tek bir Tedarikçi nesnesi.
Tedarikçi kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
kod (dize, gerekli, benzersiz) - tedarikçi kodu
ad (dize, gerekli) - tedarikçi adı
numara (dize, isteğe bağlı) - tedarikçi KDV numarası
sona erme tarihi (tarih, isteğe bağlı, YYYY-AA-GGTSS:DD:SSZ formatı) - tedarikçi için sürenin dolduğu tarih
adresler (dizi, isteğe bağlı)
kod (dize, gerekli, benzersiz) - adres kodu
ad (dize, isteğe bağlı) - adres adı
adres (dize, gerekli) - adres satırı
şehir (dize, isteğe bağlı) - adres şehri
posta kodu (dize, isteğe bağlı) - adres posta kodu
eyalet (dize, isteğe bağlı) - adres eyalet/bölge
ülke (dize, gerekli) - adres ülke kodu
varsayılan (boole, isteğe bağlı - yanlış için varsayılan) - doğruysa tedarikçinin varsayılan adresidir
irtibat kişileri (dizi, isteğe bağlı)
telefon numarası (dize, e-posta yoksa gereklidir) - irtibat kişisi telefon numarası
e-posta (dize, telefon numarası yoksa gereklidir) - irtibat kişisi e-postası
ad (dize, isteğe bağlı) - irtibat kişisinin adı
varsayılan (boole, isteğe bağlı - yanlış için varsayılan) - doğruysa, tedarikçinin varsayılan irtibat kişisidir
Varsayılan adres/iletişim kuralları:
Hem irtibat kişilerinin hem de adreslerin sırasıyla yalnızca bir varsayılan kişi veya adresi olabilir
Bir tedarikçinin adresleri varsa adreslerden birinin varsayılan adres olması gerekir
Bir tedarikçinin irtibat kişileri varsa ilgili kişilerden birinin varsayılan kişi olması gerekir
Bir tedarikçinin oluşturulmasında/güncellenmesinde, varsayılan bir iletişim/adres verilmemişse, ilk iletişim/adres varsayılan iletişim verisi olacaktır
Tedarikçi Oluşturma
GÖNDER /api/suppliers{?access_token}
Durum: mevcut
Bir Tedarikçi oluşturmak için, yeni Tedarikçinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GÖNDER /api/suppliers?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "2020-01-01T00:00:00Z", "contacts": [ { "email": "supplier@supplier.com", "phone-number": "12345678", "name": "Contact1", "default": true }, { "email": "supplier2@supplier2.com", "phone-number": "123456789", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "city": "Lisbon", "address": "Address 1 Street", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "city": "San Francisco", "address": "Address 1 Street", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Tedarikçileri Listeleme
AL /api/suppliers{?access_token}
Tedarikçileri listelemek için. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 tedarikçi verir.
Örnek URI
AL /api/suppliers?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
kimlik
numara (isteğe bağlı)
kimliğe göre filtrelenmiş tedarikçileri listeleme
kod
dize (isteğe bağlı)
koda göre filtrelenmiş tedarikçileri listeleme
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }, { "id": 987356124, "code": "Supplier2", "name": "Supplier2", "number": "213457", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier3@supplier3.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier4@supplier4.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address3", "name": "Address3", "address": "Address 3 Street", "city": "Paris", "post-code": "111-111", "state": "Paris", "country": "FR", "default": true }, { "code": "Address4", "name": "Address4", "address": "Address 4 Street", "city": "Madrid", "post-code": "111-111", "state": "Madrid", "country": "ES", "default": false } ] } ]
Yanıt 400Show
Yanıt 400Show
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Bir Tedarikçiyi Alma
AL /api/suppliers/{id}{?access_token}
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/suppliers/id?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
kimlik
sayısal (gerekli)
Tedarikçi kimliği
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Tedarikçiyi Güncelleme
GİR /api/suppliers/{id}{?access_token}
Bir Tedarikçi güncellemek için yeni Tedarikçinin özniteliklerinin bir JSON karmasını sağlayın.
İrtibat Kişileri
Verilen tedarikçi için irtibat kişileri mevcut kişilerin yerini alacaktır.
Mevcut bir kayıtla aynı ada sahip bir kişi verilirse bu ada sahip kişinin değerleri verilenlerle değiştirilir.
Herhangi bir irtibat kişisi verilmezse mevcut irtibat kişileri kaldırılır.
Adresler
Verilen adresler geçerli adreslerin yerini alacaktır.
Mevcut bir adresle aynı koda sahip bir adres verilirse bu koda sahip adresin değerleri verilenlerle değiştirilir.
Adres verilmezse mevcut adresler kaldırılır.
Bir adresin ilişkili varlıkları varsa adres kaldırılamadığından istek başarısız olur.
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GİR /api/suppliers/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Müşteri kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "2020-01-01T00:00:00Z", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 201
Yanıt 201
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Bir Tedarikçiyi Kaldırma
SİL /api/suppliers/{id}{?access_token}
Örnek URI
SİL /api/suppliers/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Tedarikçi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Supplier was deleted
Yanıt 412
Yanıt 412
Gövde
It's not possible to delete this supplier. It has dependent entities.
Müşteri
Prodsmart API’nın müşteri kaynakları.
MÜŞTERİ
Tek bir Müşteri nesnesi.
Müşteri kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
kod (dize, gerekli, benzersiz) - müşteri kodu
ad (dize, gerekli) - müşteri adı
numara (dize, isteğe bağlı) - müşteri numarası
telefon numarası (dize, isteğe bağlı) - müşteri Telefon Numarası
e-posta (dize, isteğe bağlı) - müşteri e-postası
adresler (dizi, isteğe bağlı)
kod (dize, gerekli, benzersiz) - adres kodu
ad (dize, isteğe bağlı) - adres adı
adres (dize, gerekli) - adres satırı
şehir (dize, isteğe bağlı) - adres şehri
posta kodu (dize, isteğe bağlı) - adres posta kodu
eyalet (dize, isteğe bağlı) - adres eyalet/bölge
ülke (dize, gerekli) - adres ülke kodu
varsayılan (boole, isteğe bağlı - yanlış için varsayılan) - doğruysa müşterinin varsayılan adresidir
irtibat kişileri (dizi, isteğe bağlı)
telefon numarası (dize, e-posta yoksa gereklidir) - irtibat kişisi telefon numarası
e-posta (dize, telefon numarası yoksa gereklidir) - irtibat kişisi e-postası
ad (dize, isteğe bağlı) - irtibat kişisinin adı
varsayılan (boole, isteğe bağlı - yanlış için varsayılan) - doğruysa müşterinin varsayılan irtibat kişisidir
Varsayılan adres/iletişim kuralları:
Hem irtibat kişilerinin hem de adreslerin sırasıyla yalnızca bir varsayılan kişi veya adresi olabilir
Bir müşterinin adresleri varsa adreslerden birinin varsayılan adres olması gerekir
Bir müşterinin irtibat kişileri varsa irtibat kişilerinden birinin varsayılan kişi olması gerekir
Bir müşterinin oluşturulmasında/güncellenmesinde, varsayılan bir irtibat kişisi/adres verilmemişse ilk irtibat kişisi/adres varsayılan olacaktır
Müşteri Oluşturma
GÖNDER /api/clients{?access_token}
Bir Müşteri oluşturmak için, yeni Müşterinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Müşteriyi kaydetmek mümkündür. Gelecekte, istek bir kaynak yerine bir diziyse dizideki tüm öğeler kaydedilir.
Örnek URI
GÖNDER /api/clients?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "2020-01-01T00:00:00Z", "contacts": [ { "email": "supplier@supplier.com", "phone-number": "12345678", "name": "Contact1", "default": true }, { "email": "supplier2@supplier2.com", "phone-number": "123456789", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "city": "Lisbon", "address": "Address 1 Street", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "city": "San Francisco", "address": "Address 1 Street", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Müşterileri Listeleme
AL /api/clients{?access_token}
Müşterileri listelemek için. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 müşteri verir.
Örnek URI
AL /api/clients?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
kimlik
numara (isteğe bağlı)
Kimliğe göre filtrelenmiş müşterileri listeleme
kod
dize (isteğe bağlı)
koda göre filtrelenmiş müşterileri listeleme
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }, { "id": 987356124, "code": "Supplier2", "name": "Supplier2", "number": "213457", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier3@supplier3.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier4@supplier4.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address3", "name": "Address3", "address": "Address 3 Street", "city": "Paris", "post-code": "111-111", "state": "Paris", "country": "FR", "default": true }, { "code": "Address4", "name": "Address4", "address": "Address 4 Street", "city": "Madrid", "post-code": "111-111", "state": "Madrid", "country": "ES", "default": false } ] } ]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Müşteri Alma
AL /api/clients/{id}{?access_token}
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/clients/id?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
kimlik
sayısal (gerekli)
Müşteri kimliği
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Müşteriyi Güncelleme
GİR /api/clients/{id}{?access_token}
Bir Müşteri güncellemek için yeni Müşterinin özniteliklerinin bir JSON karmasını sağlayın.
İrtibat Kişileri
Verilen tedarikçi için irtibat kişileri mevcut kişilerin yerini alacaktır.
Mevcut bir kayıtla aynı ada sahip bir kişi verilirse bu ada sahip kişinin değerleri verilenlerle değiştirilir.
Herhangi bir irtibat kişisi verilmezse mevcut irtibat kişileri kaldırılır.
Adresler
Verilen adresler geçerli adreslerin yerini alacaktır.
Mevcut bir adresle aynı koda sahip bir adres verilirse bu koda sahip adresin değerleri verilenlerle değiştirilir.
Adres verilmezse mevcut adresler kaldırılır.
Bir adresin ilişkili varlıkları varsa adres kaldırılamadığından istek başarısız olur.
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GİR /api/clients/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Müşteri kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "2020-01-01T00:00:00Z", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses":[ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ]}
Yanıt 201
Yanıt 201
Gövde
{ "code": "Supplier", "name": "Supplier", "number": "213456", "expiration-date": "01/01/2020", "contacts": [ { "phone-number": "12345678", "email": "supplier@supplier.com", "name": "Contact1", "default": true }, { "phone-number": "123456789", "email": "supplier2@supplier2.com", "name": "Contact2", "default": false } ], "addresses": [ { "code": "Address1", "name": "Address1", "address": "Address 1 Street", "city": "Lisbon", "post-code": "111-111", "state": "Lisbon", "country": "PT", "default": true }, { "code": "Address2", "name": "Address2", "address": "Address 1 Street", "city": "San Francisco", "post-code": "111-111", "state": "California", "country": "US", "default": false } ] }
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Müşteriyi Kaldırma
SİL /api/clients/{id}{?access_token}
Örnek URI
SİL /api/clients/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Müşteri kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Client was deleted
Yanıt 412
Yanıt 412
Gövde
It's not possible to delete this client. It has dependent entities.
Satış Siparişi
Prodsmart API’nın MüşteriSiparişi kaynakları.
SATIŞ SİPARİŞİ
Tek bir Satış Siparişi nesnesi. Satış Siparişi kaynağı, Prodsmart API’nın en önemli kaynaklarından biridir.
Satış Siparişi kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
kod (dize, gerekli) - satış siparişi kodu
müşteri (dize, isteğe bağlı) - müşteri kodu
gözlemler (dize, isteğe bağlı) - satış siparişi gözlemleri
ürünler (dizi, gerekli, boş değil)
kod (dize, gerekli, benzersiz) - ürün kodu
miktar (çift, gerekli, >0) - sipariş edilen miktar
teslim tarihi (tarih, isteğe bağlı, YYYY-AA-GGTSS:DD:SSZ formatı) - nakliye için verilen son tarih
talep tarihi (tarih, isteğe bağlı, YYYY-AA-GGTSS:DD:SSZ formatı) - nakliyenin talep edildiği tarih
lokasyon (dize, isteğe bağlı) - lokasyon, birden fazla konum varsa
fiyat (çift, isteğe bağlı) - ürün fiyatı
parametreler (dize, isteğe bağlı) - satış siparişine özgü bir öznitelik içerir
Satış Siparişi oluşturma
GÖNDER /api/client-order/{?access_token}
Satış Siparişi oluşturmak istiyorsanız yeni Satış Siparişi için özniteliklerin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir adet Satış Siparişini kaydetmek mümkündür. Gelecekte, istek bir kaynak yerine bir diziyse dizideki tüm öğeler kaydedilir.
Örnek URI
GÖNDER /api/client-order/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "billing-address": "San Francisco", "delivery-address": "Delivery address code", "location": "location code", "products": [ { "code": "V23076", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3, "delivery-address":"San Francisco" }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price":502, "delivery-address":"Los Angeles" } ], "parameters": [ { "name": "Sales Order Type", "value": "Regular" } ]}
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "billing-address":"San Francisco", "observations": "Ready next week", "products": [ { "code": "V23076", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3, "delivery-address":"San Francisco" }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price":502, "delivery-address":"Los Angeles" } ], "parameters": [ { "name": "Sales Order Type", "value": "Regular" } ]}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satış Siparişlerini listeleme
AL /api/client-order/{?access_token}
Satış Siparişlerini listelemek için kullanılır. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 satış siparişi verir.
Örnek URI
AL /api/client-order/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
sona-erme-tarihi-önce
tarih (isteğe bağlı)
sona erme tarihi bundan önce olan satış siparişlerini listeleyin
sona-erme-tarihi-sonra
tarih (isteğe bağlı)
sona erme tarihi bundan sonra olan satış siparişlerini listeleyin
müşteri
dize (isteğe bağlı)
makine kodu
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ], "parameters": [ { "name": "Sales Order Type", "value": "Regular" } ] }, { "id": 987356124, "code": "CO123 - Week 48", "client": "Client X", "observations": "", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 70, "due-date": "2019-08-23T18:00:00Z", "requested-date": "2019-01-16T15:19:54Z", "price": 140 }, { "code": "V23077", "quantity": 69, "due-date": "2016-08-23T18:00:00Z", "requested-date": "2019-01-16T15:19:54Z" } ], "parameters": [ { "name": "Sales Order Type", "value": "Priority" } ] }]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satış Siparişi alma
AL /api/client-order/{id}{?access_token}
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/client-order/id?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
kimlik
sayısal (gerekli)
Satış siparişi kimliği
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ], "parameters": [ { "name": "Sales Order Type", "value": "Priority" } ]}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satış Siparişini güncelleme
GİR /api/client-order/{?access_token}
Satış Siparişi güncellemek istiyorsanız yeni Satış Siparişi için özniteliklerin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GİR /api/client-order/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "billing-address": "San Francisco", "location": "location code", "products": [ { "code": "V23076", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3, "billing-address": "San Francisco" }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "billing-address": "Los Angeles" } ]}
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "billing-address": "San Francisco", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3, "billing-address": "San Francisco" }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "billing-address": "Los Angeles" } ]}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satış Siparişini kaldırma
SİL /api/client-order/{id}{?access_token}
Örnek URI
SİL /api/client-order/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Satış Siparişi kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Client order was deleted
Yanıt 409
Yanıt 409
Gövde
Client order already has production orders created or other entities associated, cannot be removed.
Satın Alma Siparişi
Prodsmart API’nın Satın Alma kaynakları.
SATIN ALMA SİPARİŞİ
Tek bir Satın Alma Siparişi nesnesi. Satın Alma Siparişi kaynağı, Prodsmart API’nın en önemli kaynaklarından biridir.
Satın Alma Siparişi kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
kod (dize, gerekli) - satın alma siparişi kodu
tedarikçi (dize, isteğe bağlı) - tedarikçi kodu
fatura adresi (dize, isteğe bağlı) - fatura adresi
gözlemler (dize, isteğe bağlı) - satın alma siparişi gözlemleri
ürünler (dizi, gerekli, boş değil)
kod (dize, gerekli, benzersiz) - ürün kodu
miktar (çift, gerekli, >0) - miktar talebi
teslim tarihi (tarih, isteğe bağlı, YYYY-AA-GGTSS:DD:SSZ formatı) - alım için verilen son tarih
talep tarihi (tarih, isteğe bağlı, YYYY-AA-GGTSS:DD:SSZ formatı) - alımın talep edildiği tarih
maliyet (çift, isteğe bağlı) - ürün maliyeti
uom (dize, isteğe bağlı) - ürün ölçüm birimi
teslimat adresi (dize, isteğe bağlı) - teslimat adresini alma
parametreler (dize, isteğe bağlı) - satın alma siparişi parametreleri
onay durumu (dize, isteğe bağlı) - taslak, inceleniyor, onaylandı, doğrulandı, reddedildi
Satın Alma Siparişi Oluşturma
GÖNDER /api/purchase-orders/{?access_token}
Bir Satın Alma Siparişi oluşturmak için, yeni Satın Alma Siparişinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Satın Alma Siparişini kaydetmek mümkündür. Gelecekte, istek bir kaynak yerine bir diziyse dizideki tüm öğeler kaydedilir.
Örnek URI
GÖNDER /api/purchase-orders/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "PO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "supplier": "Supplier X", "billing-address": "Lisbon", "observations": "Ready next week", "products": [ { "code": "V23076", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "uom": "Box", "cost": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2023-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ], "approval-status": "draft", "active": true}
Yanıt 201
Yanıt 201
Başlıklar
Content-Type: application/json
Gövde
{ "code": "PO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "supplier": "Supplier X", "billing-address": "Lisbon", "observations": "Ready next week", "products": [ { "code": "V23076", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "uom": "Box", "cost": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2023-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ], "approval-status": "draft", "active": true}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satın Alma Siparişini Alma
AL /api/purchase-orders/{id}{?access_token}
Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GET /api/purchase-orders/id?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
kimlik
sayısal (gerekli)
Satın ama siparişi kimliği
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "PO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "supplier": "Supplier X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "cost": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2023-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ]}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satın Alma Siparişini Güncelleme
GİR/api/purchase-orders/{id}{?access_token}
Bir Satın Alma Siparişi güncellemek için yeni Satın Alma Siparişinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GİR /api/purchase-orders/id?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
kimlik
sayısal (gerekli)
Satın ama siparişi kimliği
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ]}
Yanıt 201
Yanıt 201
Gövde
{ "id": 987356123, "code": "CO123 - Week 47", "creation-date": "2022-04-19T08:30:01Z", "client": "Client X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2019-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z", "price": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2016-08-16T17:15:15Z", "requested-date": "2019-01-16T15:19:54Z" } ]}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Satın Alma Siparişini Kaldırma
SİL /api/purchase-orders/{id}{?access_token}
Örnek URI
SİL /api/purchase-orders/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Satın Alma Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Purchase order was deleted
Yanıt 409
Yanıt 409
Gövde
Purchase order already has production orders created or other entities associated, cannot be removed.
Satın Alma Siparişlerini Listeleme
AL /api/purchase-orders{?access_token}
Satın Alma Siparişlerini listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 satış siparişi verir.
Örnek URI
Al /api/purchase-orders?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
kimlik
numara (isteğe bağlı)
Satın alma siparişi kimliğine göre filtrelenmiş satın alma siparişlerini listeleme
kod
dize (isteğe bağlı)
Satın alma siparişi koduna göre filtrelenmiş satın alma siparişlerini listeleme
sona-erme-tarihi-önce
tarih (isteğe bağlı)
satın alma siparişlerini bundan önceki vade tarihlerine göre listeleme
sona-erme-tarihi-sonra
tarih (isteğe bağlı)
satın alma siparişlerini bundan sonraki vade tarihlerine göre listeleme
tedarikçi
dize (isteğe bağlı)
tedarikçi koduna göre filtrelenmiş satın alma siparişlerini listeleme
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "id": 987356123, "code": "PO123 - Week 47", "creation-date": "2023-04-19T08:30:01Z", "supplier": "Supplier X", "observations": "Ready next week", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 100, "due-date": "2023-08-16T17:15:15Z", "requested-date": "2023-01-16T15:19:54Z", "cost": 200.3 }, { "code": "V23077", "quantity": 99, "due-date": "2023-08-16T17:15:15Z", "requested-date": "2023-01-16T15:19:54Z" } ] }, { "id": 987356124, "code": "PO123 - Week 48", "supplier": "Supplier X", "observations": "", "products": [ { "code": "V23076", "name": "Vessel", "quantity": 70, "due-date": "2023-08-23T18:00:00Z", "requested-date": "2023-01-16T15:19:54Z", "cost": 140 }, { "code": "V23077", "quantity": 69, "due-date": "2023-08-23T18:00:00Z", "requested-date": "2023-01-16T15:19:54Z" } ] }]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Üretim Siparişi
Prodsmart API’nın Üretim Siparişi kaynakları.
ÜRETİM SİPARİŞİ
Tek bir Üretim Siparişi nesnesi. Üretim Siparişi kaynağı, Prodsmart API’nın en önemli kaynaklarından biridir. Tanımlanmış işçiler tarafından belirli bir süre boyunca önceden belirlenmiş miktarda ürün üretmek için yönetimin verdiği talimatı temsil eder.
Üretim Siparişi kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
kod (dize, gerekli) - üretim siparişi kodu
başlangıç tarihi (tarih,gerekli, format YYYY-AA-GGTSS:DD:SSZ) - bu üretim siparişinin başlamasının planlandığı tarih
son teslimat tarihi (tarih,gerekli, format YYYY-AA-GGTSS:DD:SSZ) - bu üretim siparişinin teslim edilmesinin planlandığı tarih
ürünler (dizi, gerekli, boş değil) - sipariş edilen ürünler ve miktarlar
ürün (Dize, gerekli, benzersiz) - ürün kodu
sipariş edilen miktar (çift, gerekli, >0) - sipariş edilen miktar
gözlemler (isteğe bağlı) - bu ürün hakkında not
üretilen miktar (tam sayı, tedarik edilen, >0) - üretilen miktar
açıklama (isteğe bağlı) - bu üretim siparişi için açıklama
nakliye (isteğe bağlı) - bu sipariş için nakliye kodu
işçiler - atanan (dizi, isteğe bağlı) -
numara - işçi numarası
makineler (dizi, isteğe bağlı)
kod - makine kodu
seri numarası (isteğe bağlı)
açıklama (isteğe bağlı)
notlar (isteğe bağlı)
durum (tedarik edilen) - programlı (başlangıç_tarihi ve tamamlanma = 0 öncesinde), zamanında (bitiş_tarihi ve tamamlanma <%100’den önce), gecikmeli (bitiş_tarihi tamamlanmadan sonra <%100), tamamlandı (tamamlanma >= %100)
ilerleme durumu (tedarik edilen) - başlanmadı (üretim yok), başlandı (işlemler), kapalı (manuel olarak kapatıldı veya tamamlandığında kapatıldı), arşivlendi (manuel olarak arşivlendi)
Durum kimliği, oluşturma anında Prodsmart API tarafından atanır.
Üretim Siparişi Alma
AL /api/production-orders/{id}{?access_token}
Bir Üretim Siparişini almak için Üretim Siparişinin kimliğiyle bir AL isteği gerçekleştirmeniz yeterlidir. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/production-orders/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
işçiler
boole (isteğe bağlı)
yanıtta işçi listesini göster
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
{ "products": [ { "product": "V23076", "quantity-ordered": 3500, "observations": "", "quantity-produced": 700 } ], "code": "V23076 - Week 33/34", "shipping": { "code": "shipping 45" }, "start-date": "2023-04-20T09:15:15Z", "due-date": "2023-05-16T17:15:15Z", "description": "Woodworks Ltd.", "ended": false, "custom-fields": [ { "Order Type": "No changeover" } ], "machines": [ { "code": "A32" } ], "pieces-by-box": 20, "is-active": true, "status": "onschedule", "running-status": "started", "notes": "", "location": { "id": "location id", "code": "location code", "name": "location name" }, "material-staging-complete": true, "id": 3990}
Üretim Siparişini Güncelleme/Değiştirme
GİR /api/production-orders/{id}{?access_token}
Bir Üretim Siparişini güncellemek için Üretim Siparişinin kimliğiyle bir GİR isteği gerçekleştirmeniz yeterlidir. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GİR /api/production-orders/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
işçiler
boole (isteğe bağlı)
yanıtta işçi listesini göster
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "products": [ { "product": "V23076", "quantity-ordered": 4000, "observations": "", "quantity-produced": 700 } ], "code": "V23076 - Week 33/34", "shipping": { "code": "shipping 45" }, "start-date": "2023-04-20T09:15:15Z", "due-date": "2023-05-16T17:15:15Z", "description": "Woodworks Ltd.", "ended": false, "custom-fields": [ { "Order Type": "No changeover" } ], "machines": [ { "code": "A32" } ], "pieces-by-box": 20, "is-active": true, "status": "onschedule", "running-status": "started", "notes": "", "location": "location code", "material-staging-complete": true, "id": 3990}
Yanıt 200
Yanıt 200
Gövde
{ "products": [ { "product": "V23076", "quantity-ordered": 4000, "observations": "", "quantity-produced": 700 } ], "code": "V23076 - Week 33/34", "shipping": { "code": "shipping 45" }, "start-date": "2023-04-20T09:15:15Z", "due-date": "2023-05-16T17:15:15Z", "description": "Woodworks Ltd.", "ended": false, "custom-fields": [ { "Order Type": "No changeover" } ], "machines": [ { "code": "A32" } ], "pieces-by-box": 20, "is-active": true, "status": "onschedule", "running-status": "started", "notes": "", "location": { "id": "location id", "code": "location code", "name": "location name" }, "material-staging-complete": true, "id": 3990}
Üretim Siparişini Kaldırma
SİL /api/production-orders/{id}{?access_token}
Örnek URI
SİL /api/production-orders/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Production order was deleted
Üretim Siparişi Oluşturma
GÖNDER /api/production-orders/{?access_token}
Bir Üretim Siparişi oluşturmak için yeni Üretim Siparişinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Üretim Siparişi kaydetmek mümkündür. Gelecekte, istek bir kaynak yerine bir diziyse dizideki tüm öğeler kaydedilir.
Örnek URI
GÖNDER /api/production-orders/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
işçiler
boole (isteğe bağlı)
yanıtta işçi listesini göster
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "products": [ { "product": "productExample", "quantity-ordered": 4500, "observations": "" } ], "code": "exampleCode", "shipping": "shippingExample", "serial-number": "", "description": "", "start-date": "2023-07-20T09:15:15Z", "due-date": "2023-08-16T17:15:15Z", "parameters": [ { "name": "Custom Field Name", "value": "123" }, { "name": "Custom Field Name 2", "value": "456" } ], "workers-assigned": [ { "number": 1 }, { "number": 3 } ], "worker-groups": [ { "name": "All" } ], "ended": false, "machines": [ { "code": "exampleMachine" }, { "code": "F1" } ], "pieces-by-box": 20, "notes": "", "location": "location code", "active": true}
Yanıt 201
Yanıt 201
Gövde
{ "products": [ { "product": "productExample", "quantity-ordered": 4500, "observations": "", "quantity-produced": 0 } ], "code": "exampleCode", "shipping": "shippingExample", "serial-number": "", "description": "", "start-date": "2023-07-20T09:15:15Z", "due-date": "2023-08-16T17:15:15Z", "workers-assigned": [ { "number": 1 }, { "number": 2 } { "number": 3 } { "number": 4 } ], "ended": false, "machines": [ {"code": "exampleMachine"}, {"code": "F1"} ], "pieces-by-box": 20, "status": "scheduled", "running-status": "notstarted", "notes": "", "location": { "id": "location id", "code": "location code", "name": "location name" }, "active": true, "id": 11110}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Üretim Siparişlerini Listeleme
AL /api/production-orders/{?access_token}
Üretim Siparişlerini listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 OP verir.
Örnek URI
AL /api/production-orders/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
başlangıç-tarihi-önce
tarih (isteğe bağlı)
Üretim siparişlerini başlangıç tarihi bundan önce olacak şekilde listeleyin
başlangıç-tarihi-sonra
tarih (isteğe bağlı)
Üretim siparişlerini bundan sonraki başlangıç tarihi ile listeleyin
sona-erme-tarihi-önce
tarih (isteğe bağlı)
Üretim siparişlerini bundan önceki son tarihle listeleyin
sona-erme-tarihi-sonra
tarih (isteğe bağlı)
Üretim siparişlerini bundan sonraki son tarihle listeleyin
çalışma durumu
dize (isteğe bağlı)
başlatılmadı, başlatıldı, kapatıldı, arşivlendi
etkin
boole (isteğe bağlı)
Yalnızca etkin (doğru) veya etkin olmayan (yanlış) üretim siparişlerini listeleme
Ürün
dize (isteğe bağlı)
Ürün Kodu
makine
dize (isteğe bağlı)
makine kodu
işçiler
boole (isteğe bağlı)
yanıtta işçi listesini göster
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "products": [ { "product": "exampleProduct", "quantity-ordered": 4500, "observations": "", "quantity-produced": 0 } ], "code": "exampleCode", "shipping": "Shipping 45", "serial-number": "", "description": "", "start-date": "2023-07-20T09:15:15Z", "due-date": "2023-08-16T17:15:15Z", "workers-assigned": [ { "number": 10 }, { "number": 1 } ], "ended": false, "machines": [ { "code": "exampleMachine" }, { "code": "F1" } ], "pieces-by-box": 20, "status": "scheduled", "running-status": "notstarted", "notes": "", "location": { "id": "location id", "code": "location code", "name": "location name" }, "active": true, "id": 8763990 }]
Üretim Siparişi Sorununu Bildirme
GÖNDER /api/production-orders/{id}/notify{?access_token}
Bilgilendirmeye kısa mesaj gönderen ve Üretim Siparişine mesaj ekleyen hizmet.
kısa mesaj (dize,gerekli) - bilgilendirmede yayınlanan mesaj, maksimum uzunluk 140 karakter
mesaj (dize, isteğe bağlı) - PO’daki notlar bölümüne eklenen mesaj
Örnek URI
GÖNDER /api/production-orders/id/notify?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "short-message": "example", "message": "complete message "}
Yanıt 200
Yanıt 200
Üretim Siparişini Etkinleştirme
GÖNDER /api/production-orders/{id}/activate{?access_token}
Üretim Siparişini etkinleştiren hizmet.
Örnek URI
GÖNDER /api/production-orders/id/activate?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Siparişi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{}
Yanıt 200
Yanıt 200
Yanıt 204
Yanıt 204
Gövde
Production Order was already active
Yanıt 405
Yanıt 405
Gövde
Production Order was closed or archived and cannot be activated
Ürünler
Prodsmart API’nın ürün kaynakları.
ÜRÜN
Tek bir Ürün nesnesi. Ürün kaynağı, Prodsmart API’nın en önemli kaynaklarından biridir. Bir fabrikadaki ürünleri temsil eder ve üretilmesi için gerekli işlemleri içerir. Bu yöntem yeni Ürün ve İşlemleri oluşturur. Ayrıca kullanılabilir
Ürün kaynağı aşağıdaki özniteliklere sahiptir:
kod (dize, gerekli) - ürün kodu
ad (dize, gerekli) - ürün adı
bölüm (dize, isteğe bağlı)
aileler (dizi, isteğe bağlı)
işlemler (dizi, isteğe bağlı) - ürünü üretmek için yapılan işlemler
kod (dize, gerekli) - işlem kodu
ad (dize, gerekli) - işlem adı
atık (dizi, isteğe bağlı)
görev süreleri (dizi, isteğe bağlı, maksimum:1)
süre (süre, isteğe bağlı, örneğin format “10S59d59s”) - teoride bu işlemin yürütülmesi için geçen ortalama süre
süre-müşteri (zaman, isteğe bağlı, örneğin format “10S59d59s”) - bütçede belirlenen zaman
oran-miktar (çift, isteğe bağlı, varsayılan: 1.0) - bu işlemin her bir örneğinde üretilen birim
Ürün başına tekrar sayısı (tam sayı, isteğe bağlı, varsayılan: 1) - Bir ürün birimini tamamlamak için bu işlemin kaç kez gerçekleştirilmesi gerektiği
özel alanlar (dizi, isteğe bağlı, sistemde bulunmalıdır) - işleme eklenecek özel alanlar
ad (dize, gerekli) - sistemde zaten oluşturulmuş özel alan adı
makineler (dizi, isteğe bağlı, sistemde bulunmalıdır) - işlemi gerçekleştirmek için kullanılabilecek makineler
kod (dize, gerekli) - sistemde zaten oluşturulmuş makine kodu
devre dışı (boole, isteğe bağlı) - işlemi devre dışı bırakın
isteğe bağlı (boole, isteğe bağlı) - işlemi isteğe bağlı olarak ayarlayın
kurtarma (boole, isteğe bağlı) - işlemi kurtarma olarak ayarlayın
zaman yok (boole, isteğe bağlı) - üretim sürelerini kaydetmeyin
miktar yok (boole, isteğe bağlı) - üretim miktarını kaydetmeyin
ekip olarak (boole, isteğe bağlı) - ekip olarak gerçekleştirilecek işlem
maks atık eşiği (çift, isteğe bağlı) - izin verilecek maksimum atık oranı
İstekte bulunmayan alanlar varsayılan değerlerle ayarlanır. Mevcut ürünler/işlemler için bu yöntemi kullanırken, mevcut olmayan alanlar silme işlemi olarak kabul edilir.
Ürünü Geri Alma
AL /api/products/{code}{?access_token}
Bir Ürünü almak için, Ürünün koduyla bir AL isteği gerçekleştirmeniz yeterlidir. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/products/code?access_token=
URI Parametreleri
URI Parametreleri
kod
Dize (gerekli)
Ürün kodu.
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
{ "code": "P11", "name": "Product 11", "section": null, "families": null, "color": "#8b0000", "observations": "observations", "operations": [ { "code": "op1", "name": "op1", "waste": null, "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "custom-fields": null, "machines": null, "disabled": false, "optional": false, "recovery": null, "no-time": false, "no-quantity": false, "as-team": false, "max-waste-threshold": null, "section": { "name": "specialsection" }, "id": 100 } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" }, { "name": "parameter3", "value": 1 } ], "label": { "code": "labelCode" }, "serializable": true, "id": 24}
Yanıt 404
Yanıt 404
Gövde
If product with the provided code doesn't exist.
Ürün Oluşturma
GÖNDER /api/products{?access_token}
Bir Ürün oluşturmak için yeni Ürün ve İşlemleri için özniteliklerin JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Aynı anda birden fazla İşlem oluşturulabilir.
Örnek URI
GÖNDER /api/products?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "P11", "name": "Product 11", "families": [ { "code": "FG" } ], "color": "#8b0000", "observations": "observations", "operations": [ { "code": "op1", "name": "op1", "waste": [ { "code": "BROKEN" } ], "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "times-per-product": 2.0, "checklists": [ { "code": "CheckIn" } ], "machines": [ { "code": "OVEN02" } ], "disabled": false, "optional": false, "recovery": false, "no-time": false, "no-quantity": false, "as-team": false, "multi-po": false, "print-production-barcode": false, "prepare-batch-order": false, "section": { "name": "CUT" } } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" } ], "serializable": true}
Yanıt 201
Yanıt 201
Gövde
{ "code": "P11", "name": "Product 11", "families": [ { "code": "FG" } ], "color": "#8b0000", "observations": "observations", "operations": [ { "code": "op1", "name": "op1", "waste": [ { "code": "BROKEN" } ], "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "times-per-product": 2.0, "checklists": [ { "code": "CheckIn" } ], "custom-fields": null, "machines": [ { "code": "OVEN02" } ], "disabled": false, "optional": false, "recovery": null, "no-time": false, "no-quantity": false, "as-team": false, "section": { "name": "CUT" } "id":560 } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" } ], "serializable": true "id":120}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürün Güncelleme
GİR /api/products/{code}{?access_token}
Bir Ürünü güncellemek üzere mevcut Ürün ve İşlemleri için bir kod ve JSON öznitelik karması sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Ürünü kaydetmek mümkündür, ancak aynı anda birden fazla İşlem oluşturulabilir.
Örnek URI
PUT /api/products/code?access_token=
URI Parametreleri
URI Parametreleri
kod
dize (gerekli)
Ürün kodu.
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "code": "P11", "name": "Product 11", "families": [ { "code": "FG" } ], "color": "#8b0000", "observations": "observations", "operations": [ { "code": "op1", "name": "op1", "waste": [ { "code": "BROKEN" } ], "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "times-per-product": 2.0, "checklists": [ { "code": "CheckIn" } ], "custom-fields": null, "machines": [ { "code": "OVEN02" } ], "disabled": false, "optional": false, "recovery": null, "no-time": false, "no-quantity": false, "as-team": false, "section": { "name": "CUT" } } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" } ], "serializable": true}
Yanıt 201
Yanıt 201
Gövde
{ "code": "P11", "name": "Product 11", "families": [ { "code": "FG" } ], "color": "#8b0000", "observations": "observations", "operations": [ { "code": "op1", "name": "op1", "waste": [ { "code": "BROKEN" } ], "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "times-per-product": 2.0, "checklists": [ { "code": "CheckIn" } ], "custom-fields": null, "machines": [ { "code": "OVEN02" } ], "disabled": false, "optional": false, "recovery": null, "no-time": false, "no-quantity": false, "as-team": false, "section": { "name": "CUT" } "id":560 } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" } ], "serializable": true "id":120}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürün Silme
SİL /api/products/{code}{?access_token}
Bir Ürünü silmek için Ürün kodunu girin.
Örnek URI
SİL /api/products/code?access_token=
URI Parametreleri
URI Parametreleri
kod
dize (gerekli)
Ürün kodu.
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
Content-Type: application/json
Yanıt 204
Yanıt 204
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürünleri Listeleme
AL /api/products{?access_token}
Ürünleri ve İşlemlerini listelemek için. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/products?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
ürün-ailesi-kodu
dize (isteğe bağlı)
sağlanan ürün ailesine ait ürünleri listeleme
düzenleme-tarihi
tarih (isteğe bağlı)
sağlanan tarihten sonra arka ofis aracılığıyla değiştirilen ürünleri listeleme
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
{ "code": "P11", "name": "Product 11", "observations": "", "section": null, "unit-cost": null, "unit-price": 4.32000, "families": [ { "code": "FG", "name": "Finished Goods" } ], "operations": [ { "code": "op1", "name": "op1", "waste": null, "task-durations": [ { "validSince": "01/01/2022 - 13:00", "validUntil": "01/01/2100 - 13:00", "duration": "00H01m00s", "duration-customer": "00H01m00s", "ratio-quantity": 1 } ], "custom-fields": null, "parameters": [ { "name": "parameter1", "value": "value1" } ], "machines": null, "disabled": false, "optional": false, "recovery": null, "no-time": false, "no-quantity": false, "as-team": false, "max-waste-threshold": null, "section": { "name": "specialsection" }, "id": 123 } ], "components": [ { "code": "SUGAR", "name": "Sugar", "quantity": 0.0015, "operation": "MIXING" }, { "code": "VANILLA", "name": "Vanilla", "quantity": 0.0008, "operation": "MIXING" } ], "serializable": false, "custom-fields": null}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
ÜRÜN MALZEME LİSTESİ
Ürün Malzeme Listesi (BoM) kaynağı, belirli bir ürünü üretmek için kullanılan malzemeleri belirtir. BoM, aşağıdaki özniteliklere sahiptir:
ürün kodu - ana ürün
bom (dizi,gerekli)
ürün kodu (dize, gerekli) - bileşen/tüketim ürün kodu
miktar (çift, gerekli) - miktar
işlem kodu (dize, isteğe bağlı) - ürün kodunda tanımlanan malzemenin tüketildiği işlem kodu. Boş olması durumunda tüketim, bu ürün için üretim sürecinin ilk işleminde gerçekleşecektir.
Ürün Malzeme Listesini (BOM) Güncelleme
GÖNDER /api/bom{?access_token}
Bir Ürün Malzeme Listesini güncellemek için yeni Ürünün ve İşlemlerinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GÖNDER /api/bom?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "product-code": "bicycle", "bom": [ { "product-code": "wheel", "quantity": 2, "operation-code": "assemble" }, { "product-code": "seat", "quantity": 1, "operation-code": "assemble" } ]}
Yanıt 201
Yanıt 201
{ "product-code": "bicycle", "bom": [ { "product-code": "wheel", "quantity": 2, "operation-code": "assemble" }, { "product-code": "seat", "quantity": 1, "operation-code": "assemble" } ]}
Yanıt 404
Yanıt 404
Gövde
Main product not found
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
ÜRÜN STOKU
Stok kaynağı, belirli bir ürün için belli bir stoku gerektirir.
ürün-kodu (dize, gerekli)
stok (çift, gerekli)
tarih (tarih, isteğe bağlı) - stok sayımının tarihi
Ürün Stokunu Güncelleme
GÖNDER /api/stock{?access_token}
Bir Ürünün stokunu güncellemek için mevcut stokun özniteliklerinin JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GÖNDER /api/stock?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "product-code": "bicycle", "stock": 200.5, "date": "2023-08-16T17:15:15Z"}
Yanıt 201
Yanıt 201
Gövde
Request successful
Yanıt 404
Yanıt 404
Gövde
Product not found
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürün Aileleri
Prodsmart API’nın ürün kaynakları.
ÜRÜN AİLESİ
Ürün Ailesi nesnesi, bir ürünün ait olduğu aileyi veya aileleri temsil eder.
Ürün Ailesi kaynağı aşağıdaki özniteliklere sahiptir:
kod (dize, gerekli) - ürün ailesi kodu
ad (dize, gerekli) - ürün ailesi adı
Ürün Ailesi Oluşturma
GÖNDER /api/product-families{?access_token}
Bir veya daha fazla Ürün Ailesi oluşturmak için. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
GÖNDER /api/product-families?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "product-families": [ { "code": "FAM 1", "name": "Family 1" }, { "code": "FAM 2", "name": "Family 2" } ]}
Yanıt 201
Yanıt 201
Gövde
[ { "code": "FAM 1", "name": "Family 1" }, { "code": "FAM 2", "name": "Family 2" }]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürün Ailesini Silme
SİL /api/product-family/{code}{?access_token}
Bir Ürün Ailesini silmek için ÜrünAilesi kodunu sağlayın
Örnek URI
SİL /api/product-family/code?access_token=
URI Parametreleri
URI Parametreleri
kod
dize (gerekli)
Ürün kodu.
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
Content-Type: application/json
Yanıt 204
Yanıt 204
Gövde
Product Family was deleted
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Ürün Ailelerini Listeleme
AL /api/product-families{?access_token}
Ürün Ailelerini listelemek için. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/product-families?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
[ { "code": "FAM 1", "name": "Family 1" }, { "code": "FAM 2", "name": "Family 2" }]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Makineler
Prodsmart API’nın üretim kaynakları.
SAYAÇ
Sayacı güncelleme
GÖNDER /api/machines/{machine_code}/counter{?access_token}
Makinedeki geçerli sayacı güncellemek için aşağıdaki isteği göndermeniz yeterlidir. Makine bağlantısını basitleştirmek için erişim_belirteci kullanabilir veya temel kimlik doğrulaması ile kimlik doğrulama başlığında api kimlik bilgilerini gönderebilirsiniz. Prodsmart, söz konusu makinede işçi tarafından başlatılan üretimi otomatik olarak güncelleyecektir. Hem miktar sayımı hem de atık miktarları artımlı olmalıdır (yani her zaman daha önce gönderilen miktarlardan daha büyük olmalıdır).
Örnek URI
GÖNDER /api/machines/machine_code/counter?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
makine_kodu
dize (gerekli)
Prodsmart platformunda tanımlanan makine kodu
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "count": 500, "waste": [ { "code": "Waste1", "quantity": 20 } ], "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" }, { "name": "parameter3", "value": 1 } ]}
Yanıt 200
Yanıt 200
Gövde
Returns the new value for the machine's counter.
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
PARAMETRELER
Parametreleri güncelleme
GÖNDER /api/machines/{machine_code}/parameters{?access_token}
Bir makine parametresini güncellemek için aşağıdaki isteği göndermeniz yeterlidir. Makine bağlantısını basitleştirmek için erişim_belirteci kullanabilir veya temel kimlik doğrulaması ile kimlik doğrulama başlığında api kimlik bilgilerini gönderebilirsiniz. Bu parametreler geçildiğinde, bir üretim kaydı
Örnek URI
GÖNDER /api/machines/machine_code/parameters?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
makine_kodu
dize (gerekli)
Prodsmart platformunda tanımlanan makine kodu
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "parameters": [ { "code": "temperature", "value": 25 }, { "code": "valid", "value": "yes" } ]}
Yanıt 200
Yanıt 200
ÇALIŞMAMA SÜRESİ
Çalışmama süresini güncelleme
GÖNDER /api/machines/{machine_code}/startstop{?access_token}
Makinedeki mevcut durumu güncellemek için aşağıdaki isteği göndermeniz yeterlidir. Makine bağlantısını basitleştirmek için erişim_belirteci kullanabilir veya temel kimlik doğrulaması ile kimlik doğrulama başlığında api kimlik bilgilerini gönderebilirsiniz. Prodsmart, alınan bilgilere göre otomatik olarak bir çalışmama süresi kaydedecek veya sonlandıracaktır. Makine durduruldu için 0, açıksa 1 gönderin ve çalışmama süresi türünü belirtin.
Bir makine durumunu güncellemek için aşağıdaki öznitelikleri belirtin:
tür (dize, gerekli, makineye önceden atanmış bir çalışmama süresi türü olmalıdır) - Çalışmama süresi türü
çalışıyor (sayı, gerekli, 0 veya 1) - makine durduruldu mu (0) yoksa çalışıyor mu (1)
Örnek URI
GÖNDER /api/machines/machine_code/startstop?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
makine_kodu
dize (gerekli)
Prodsmart platformunda tanımlanan makine kodu
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "type": "Maintenance", "running": 0}
Yanıt 200
Yanıt 200
Üretim
Prodsmart API’nın üretim kaynakları.
ÜRETİM
Tek bir Üretim nesnesi. Üretim kaynağı, Prodsmart API’nın merkezi kaynağıdır. Bir süre boyunca bir pozisyondaki bir işçinin emeğini temsil eder.
Üretim kaynağı aşağıdaki özniteliklere sahiptir:
kimlik
başlangıç saati (tarih, gerekli, format YYYY-AA-GGTSS:DD:SSZ) - üretim başlangıç saati
bitiş saati (tarih, gerekli, format YYYY-AA-GGTSS:DD:SSZ) - üretim bitiş saati
çalışma süresi (süre, verilen, format 00H00d00s) - üretim çalışma süresi (program süresi-giriş/çıkış saatlerinde ve çalışmama süreleri hariç)
üretim-siparişi (isteğe bağlı) - bu üretimin yapıldığı üretim siparişi
kod (dize, gerekli) - üretim siparişi kodu
kimlik (dize, gerekli)
işlem (gerekli) - bu üretimde yerine getirilen görev
kod (dize, gerekli, benzersiz) - görev kodu
ürün (gerekli) - işçinin bu pozisyonda çalıştığı malzeme öğesi
miktar (tam sayı, gerekli, >0) - bu üretimde üretilen miktar
işçi (gerekli) - görevleri yerine getiren kişi
numara (uzun, gerekli, benzersiz) - işçi numarası
üretilen atık (dizi, isteğe bağlı) - bir işlemdeki kusurlu malzeme çıkışı
miktar (sayısal, gerekli) - atık kodu
atık - kusurlu malzemenin türü
kod (dize, gerekli, benzersiz) - atık kodu
açıklama (dize, gerekli) - atık açıklaması
kusur (dize, gerekli) - atık türü
miktar (tam sayı, gerekli) - üretilen atık miktarı
Durum kimliği, oluşturma anında Prodsmart API tarafından atanır.
Üretimi Güncelleme
GİR /api/productions/{id}{?access_token}
Bir Üretimi güncellemek için mevcut Üretim için bir kod ve JSON öznitelik karması sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Ürünü kaydetmek mümkündür, ancak aynı anda birden fazla İşlem oluşturulabilir.
Örnek URI
GİR /api/productions/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "shipping": { "code": "shippingexamplecode00" }, "production-order": { "code": "productionorderexample00" }, "operation": { "product-code": "otherProductCode", "code": "OtherOperationCode" }, "worker": { "number": "1000" }, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" }, { "name": "parameter3", "value": 1 } ], "quantity": 100, "start-time": "2023-07-20T09:15:15Z", "end-time": "2023-07-20T09:15:16Z", "lot-number": "other lot", "finished": false}
Yanıt 200
Yanıt 200
Gövde
{ "id": 4629374, "production-order": { "code": "productionorderexample00", "id": 365315 }, "shipping": { "code": "shippingexamplecode00", "id": 41741 }, "operation": { "code": "OtherOperationCode", "product-code": "otherProductCode", "id": 790486 }, "worker": { "number": 1000, "name": "Worker Name", "id": 15890 }, "parameters": [ { "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" }, { "name": "parameter3", "value": 1 } ], "quantity": 100, "lot-number": "other lot", "start-time": "2023-07-20T09:15:15.000Z", "end-time": "2023-07-20T09:15:16.000Z", "finished": false}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Üretimi Silme
SİL /api/productions/{id}{?access_token}
Bir Üretimi silmek için bir üretim Kimliği sağlayın.
Örnek URI
SİL /api/productions/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Üretim Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
Content-Type: application/json
Yanıt 201
Yanıt 201
Gövde
{ "id": 4629376, "production-order": { "code": "productionorderexample00", "id": 365315 }, "shipping": { "code": "shippingexamplecode00", "id": 41741 }, "operation": { "code": "operationexample0001", "product-code": "productcodeexample001", "id": 790486 }, "worker": { "number": 1000, "name": "worker example", "id": 15890 }, "parameters": [{ "name": "parameter1", "value": "value1" }, { "name": "parameter2", "value": "2022-12-19T00:00:00Z" }, { "name": "parameter3", "value": 1.0 }], "quantity": 100.0, "lot-number": "lotX", "start-time": "2023-07-20T09:15:15.000Z", "end-time": "2023-07-20T09:15:16.000Z", "finished": false}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body
Üretimleri Listeleme
AL /api/productions{?access_token}
Üretimleri listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 üretim verir.
Örnek URI
AL /api/productions?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
üretim-siparişi-kimliği
sayısal (isteğe bağlı)
bu üretim siparişinin olduğu üretimleri listeleme
üretim-siparişi-kodu
dize (isteğe bağlı)
bu (veya bunlar) üretim sipariş(ler)inin olduğu üretimleri listeleme
işçi
sayısal (isteğe bağlı)
bu işçinin olduğu üretimleri listeleme (işçi numarası)
başlangıç-saati-önce
tarih (isteğe bağlı)
bundan önce başlangıç zamanı olan üretimleri listeleme
başlangıç-saati-sonra
tarih (isteğe bağlı)
bundan sonra başlangıç zamanı olan üretimleri listeleme
bitiş-saati-önce
tarih (isteğe bağlı)
bundan önce bitiş zamanı olan üretimleri listeleme
bitiş-saati-sonra
tarih (isteğe bağlı)
bundan sonra bitiş zamanı olan üretimleri listeleme
başlangıç-saati
tarih (isteğe bağlı)
Bu başlangıç saatinden sonra çalışan yapımları listeleme (-önce -sonra ile birlikte kullanmayın)
check-out yapıldı
boole (isteğe bağlı)
check-out yapılan ürünleri listeleme.
işçi adı
boole (isteğe bağlı)
yalnızca işçinin numarası yerine adını ve numarasını alır.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "production-order": { "code": "PO1", "id": 36530 }, "operation": { "code": "2", "product": "Product 1" }, "worker": { "number": 2 }, "machine": { "code": "Machine Code" }, "produced-waste": [ { "quantity": 21, "waste": { "code": "Waste code", "description": "Description of this type of waste", "flaw": "Flaw", "recoverable": true, "billable": false, "id": 333 } } ], "parameters": [ { "parameter1": "value1" }, { "parameter2": 2 } ], "quantity": 0, "checked-out": false, "work-time": "00H00m00s", "start-time": "2023-09-20T17:55:32.000+01:00", "end-time": "2023-09-20T18:45:00.000+01:00", "id": 575354 }]
Çalışmama Süresi
Prodsmart API’nın çalışmama süresi kaynakları.
ÇALIŞMAMA SÜRELERİ
Çalışmama Sürelerini Listeleme
AL /api/downtimes{?access_token}
Çalışmama sürelerini listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/downtimes?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
başlangıç-saati-önce
tarih (isteğe bağlı)
başlangıç zamanı bundan önce olan çalışmama sürelerini listeleme
başlangıç-saati-sonra
tarih (isteğe bağlı)
başlangıç zamanı bundan sonra olan çalışmama süresi siparişlerini listeleme
bitiş-saati-önce
tarih (isteğe bağlı)
bitiş zamanı bundan önce olan çalışmama sürelerini listeleme
bitiş-saati-sonra
tarih (isteğe bağlı)
bitiş zamanı bundan sonra olan çalışmama sürelerini listeleme
makine
sayısal (isteğe bağlı)
bu makinedeki çalışmama sürelerini listele
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "id": 20146, "start-time": "2017-12-21T10:30:21.000Z", "end-time": "2017-12-21T10:32:21.000Z", "started-by": { "number": 2 }, "closed-by": { "number": 2 }, "workers": [], "machines": [ { "code": "M2", "name": "Machine 2" } ], "product": "ProdX", "production-order": "OP XPTO", "checked-out": true, "downtime-type": "Malfunction", "time-spent": "00H02m00s" }]
Giriş/ÇıkışSaati
Prodsmart API’nın Giriş/ÇıkışSaati kaynakları.
GİRİŞ/ÇIKIŞSAATİ
Uygulamadaki entegrasyonlar menüsünden giriş/çıkış saati olayları için web kancaları kullanılabilir. Bu özelliği kullanmak için lütfen takip etmek istediğiniz bildirim olaylarıyla birlikte bitiş noktası URL geri aramayı ekleyin. Sistemimizde olaylar meydana gelir gelmez web kancası bildirimlerini hızlı bir şekilde göndermeye çalışıyoruz. Mevcut durumda herhangi bir yeniden deneme işlemi desteklenmiyor.
Giriş/çıkış Saatlerini Listeleme
AL /api/punchclocks{?access_token}
Giriş/çıkış saatlerini listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/punchclocks?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
tarih-önce
tarih (isteğe bağlı)
tarihi bundan önce olan giriş/çıkış saati girişlerini listeleme
tarih-sonra
tarih (isteğe bağlı)
tarihi bundan sonra olan giriş/çıkış saati girişlerini listeleme
işçi
sayısal (isteğe bağlı)
bu işçi için giriş/çıkış saati girişlerini listeleme
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[{ "id": 372179, "date": "2018-09-21T09:24:06.000+01:00", "worker": { "number": 2 }, "type": 1},{ "id": 372180, "date": "2018-09-21T16:34:12.000+01:00", "worker": { "number": 2 }, "type": 0}]"type": 0 ('out') or 1 ('in')
Envanter Hareketi
Prodsmart API’nın Envanter Hareketi kaynakları.
ENVANTER HAREKETİ
Tek Envanter Hareketi nesnesi. Envanter Hareketi kaynağı, Prodsmart API’nın en önemli kaynaklarından biridir.
Envanter Hareketi kaynağı aşağıdaki özniteliklere sahiptir:
kimlik (ürünle verilir)
ürün (dize, gerekli) - ürün kodu
tarih-saat (tarih, isteğe bağlı, format YYYY-AA-GGTSS:DD:SSZ) - envanter hareketinin oluşturulduğu tarih
miktar (çift, gerekli) - envanter hareketi miktarı
tür (dize, gerekli) - envanter hareketi türü: giriş, çıkış, tüketim, üretim
lot (dize, isteğe bağlı) - kullanılacak envanter hareketi lotu
toplam maliyet (büyükondalık, isteğe bağlı) - envanter hareketi miktar için toplam maliyet
depo_konum (dize, isteğe bağlı) - depo konumu kodu
depo (dize, isteğe bağlı) - depo kodu
lokasyon (dize, isteğe bağlı) - lokasyon, birden fazla konum varsa
yorum (dize, isteğe bağlı) - envanter hareketi yorumu
Envanter Hareketi Alma
AL /api/inventory-movements/{id}{?access_token}
Bir Envanter Hareketini almak için, Envanter Hareketinin kimliğiyle bir AL isteği gerçekleştirmeniz yeterlidir. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/inventory-movements/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
sayısal (gerekli)
Envanter Hareketi Kimliği
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
{ "product-code": "ProductCode", "date-time": "2018-07-20T09:15:15Z", "quantity": "10", "type": "in", "lot": "A", "total-cost": "1000", "comment": "OK", "warehouse-location": "Zone2", "shipping": { "code": "shippingCode", "clientOrder": { "code": "clientOrderCode", "client": "clientCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } }, "receiving": { "code": "receivingCode", "purchaseOrder": { "code": "purchaseOrderCode", "supplier": "supplierCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } }}
Envanter Hareketi Oluşturma
GÖNDER /api/inventory-movements/{?access_token}
Bir Envanter Hareketi oluşturmak için yeni Envanter Hareketinin özniteliklerinin bir JSON karmasını sağlayın. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Şimdilik sadece bir Envanter Hareketi kaydetmek mümkündür. Gelecekte, istek bir kaynak yerine bir diziyse dizideki tüm öğeler kaydedilir.
Örnek URI
GÖNDER /api/inventory-movements/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "product-code": "ProductCode", "date-time": "2018-07-20T09:15:15Z", "quantity": "10", "type": "in", "lot": "A", "total-cost": "1000", "comment": "OK", "warehouse": "A", "warehouse-location": "Zone2", "location": "location code", "shipping": "shippingCode", "client-order": "clientOrderCode", "receiving": "receivingCode", "purchase-order": "purchaseOrderCode"}
Yanıt 200
Yanıt 200
Gövde
{ "product-code": "ProductCode", "date-time": "2018-07-20T09:15:15Z", "quantity": "10", "type": "in", "lot": "A", "total-cost": "1000", "comment": "OK", "warehouse-location": "Zone2", "id": 12345, "shipping": { "code": "shippingCode", "clientOrder": { "code": "clientOrderCode", "client": "clientCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } }, "receiving": { "code": "receivingCode", "purchaseOrder": { "code": "purchaseOrderCode", "supplier": "supplierCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } }}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body.
Envanter Hareketini güncelleme
GİR /api/inventory-movements/{id}{?access_token}
Bir Envanter Hareketini güncellemek için Envanter Hareketinde güncellemek istediğiniz özniteliklere sahip bir JSON sağlayın (tüm öznitelikler isteğe bağlıdır). Bu eylem için şu gereklidir: access_token
şununla: productions_write scope
.
Örnek URI
GİR /
api/inventory-movements/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
numeric
(gerekli)
Envanter Hareketi Kimliği
erişim_belirteci
string
(gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Gövde
{ "product-code": "ProductCode", "date-time": "2018-07-20T09:15:15Z", "quantity": "10", "type": "in", "lot": "A", "total-cost": "1000", "comment": "OK", "warehouse": "A", "warehouse-location": "Zone2", "receiving": "receivingCode" }
Envanter Hareketini silme
SİL /api/inventory-movement/{id}{?access_token}
Bir Envanter Hareketini silmek için bir Envanter Hareketi Kimliği sağlayın.
Örnek URI
SİL /api/inventory-movement/id?access_token=
URI Parametreleri
URI Parametreleri
kimlik
numeric
(gerekli)
Envanter Hareketi Kimliği
erişim_belirteci
string
(gerekli)
Prodsmart API erişim belirteci.
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 204
Yanıt 400
Yanıt 400
It's not possible to delete this inventory-movement.
Envanter Hareketlerini Listeleme
AL /api/inventory-movements/{?access_token}
Envanter Hareketlerini listelemek için. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir. Bu hizmet sayfalandırılır ve sayfa başına 25 envanter hareketi verir.
Örnek URI
AL /api/inventory-movements/?access_token=
URI Parametreleri
URI Parametreleri
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
ürün-kodu
dize (isteğe bağlı)
Ürün Kodu
tür
dize (isteğe bağlı)
envanter hareketi türü: giriş, çıkış, tüketim, üretim
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "product-code": "ProductCode", "date-time": "2018-07-20T09:15:15Z", "quantity": "10", "type": "in", "lot": "A", "total-cost": "1000", "comment": "OK", "warehouse-location": "Zone2", "id": 12345, "shipping": { "code": "shippingCode", "clientOrder": { "code": "clientOrderCode", "client": "clientCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } }, "receiving": { "code": "receivingCode", "purchaseOrder": { "code": "purchaseOrderCode", "supplier": "supplierCode" }, "location": { "id": "location id", "code": "location code", "name": "location name" } } }]
Stok
Prodsmart API’nın stok kaynakları.
Ürün Stokunu Alma
AL /api/stock/{code}{?access_token}
Bir Ürün Stokunu almak için Ürünün koduyla bir AL isteği gerçekleştirmeniz yeterlidir. Birden çok parametre bir VE koşulu olarak ele alınacaktır. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/stock/code?access_token=
URI Parametreleri
URI Parametreleri
kod
dize (gerekli)
Ürün kodu.
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci.
lot
dize (isteğe bağlı)
Ürün lotları için lot kodunu ve stok miktarını alın
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
{"product-code": "Example","stock": 35,"lot": [ { "code": "A", "stock": 10 }, { "code": "B", "stock": 5 }}
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body.
Raporlar
Prodsmart API’nın raporlama kaynakları.
İşçi İşçilik Süresi
İşçi İşçilik Süresi GET/api/reports/worker-labor-time{?access_token}
Bir raporu almak üzere raporu çıkarmak için zaman aralığına sahip bir AL isteği gerçekleştirmeniz yeterlidir. Raporu filtrelemek için işçi ve bölüm parametresi ekleyebilirsiniz. Bunun yanı sıra, rapor içeriğini özelleştirmek için bazı bayraklar belirtebilirsiniz. Tüm bayrakların varsayılan değeri yanlış değeridir. Bu eylem, üretimleri_yazma kapsamı olan bir erişim_belirteci gerektirir.
Örnek URI
AL /api/reports/worker-labor-time?access_token=
URI Parametreleri
URI Parametreleri
başlangıç-saati
dize (gerekli)
Bundan sonraki tarihler için rapor oluştur (dahil)
bitiş-zamanı
dize (gerekli)
Bundan önceki tarihler için rapor oluştur (dahil)
erişim_belirteci
dize (gerekli)
Prodsmart API erişim belirteci
işçi-numarası
dize (isteğe bağlı)
Raporu filtrelemek için bir işçi numarası belirtin
bölüm
dize (isteğe bağlı)
Bir bölüm adı belirtin. Bu bölümdeki tüm işçiler rapora dahil edilecektir
elden-geçirmeyi-göster
boole (isteğe bağlı)
Rapora elden geçirme işlemleri içeren yeni bir alan ekleme
hafta-sonunu-göster
boole (isteğe bağlı)
Verilere hafta sonu günlerini ekleme
sadece-giriş/çıkış-saati
boole (isteğe bağlı)
Mevcudiyet süresini yalnızca giriş/çıkış saatine göre belirle
sayfa
sayısal (isteğe bağlı)
sonuç sayfası dizini, 1’den başlayarak
İstek
İstek
Başlıklar
Content-Type: application/json
Yanıt 200
Yanıt 200
Gövde
[ { "worker": { "number": "0", "name": "John" }, "presence-time": "08H00", "work-time": "04H00m00s", "percentage": "50%", "calendar-downtimes": "00H00m00s" }, { "worker": { "number": "1", "name": "Mary" }, "presence-time": "08H00", "work-time": "08H00m00s", "percentage": "100%", "calendar-downtimes": "00H00m00s" }]
Yanıt 400
Yanıt 400
Gövde
If there's a problem with the request, the problem found will be reported on the Response Body.
Yanıt 429
Yanıt 429
Gövde
Another request is ongoing for this endpoint. Please wait until the current request finishes before doing another.
Erişim Yetkilendirmesi ve Kontrolü
Prodsmart Kimlik Doğrulama belirtecine erişim ve kontrol.
YETKİLENDİRME
Yetkilendirme Kaynağı, şirkete verilen bir yetkiyi temsil eder. Yalnızca kendi yetkilendirmenize erişebilirsiniz. Kullanılan kimlik doğrulaması Temel kimlik doğrulamasıdır, kimlik Doğrulama başlığı <base64 kodlu değer API_KEY:API_SECRET> biçimindedir. API Anahtarını ve Parolasını almak için Prodsmart’ta oturum açın ve kullanıcınızı düzenleyin. (Not: Bunu yapabilmek için yönetici rolüne sahip olmanız gerekir). Yetkilendirme Kaynağı aşağıdaki özniteliğe sahiptir:
belirteç
kapsamlar
Burada belirteç bir belirteci temsil eder ve kapsamlar, verilen yetki için verilen bir kapsamlar dizisidir. Şu anda mevcut olan tek kapsam productions_write
.
Yetkilendirmeyi Alma
AL /api/authorization
Var olan bir erişim belirtecini almak için AL öğesini kullanın. Bir belirteç henüz yoksa GÖNDER yöntemi kullanılarak bir belirteç oluşturulabilir.
Örnek URI
AL /api/yetkilendirme
İstek
İstek
Başlıklar
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Yanıt 200
Yanıt 200
Başlıklar
Content-Type: application/jsonLink: <http:/api.prodsmart.com/api/authorizations>;rel="self"
Gövde
{ "_links": { "self": { "href": "/api/authorizations" }, }, "scopes": [ "productions_write" ], "token": "abc123"}
Yetkilendirme Oluşturma
GÖNDER /api/authorization
Yeni bir erişim belirteci oluşturmak için GÖNDER öğesini kullanın.
Örnek URI
GÖNDER /api/authorization
İstek
İstek
Başlıklar
Content-Type: application/jsonAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Gövde
{ "scopes": [ "productions_write" ] }
Yanıt 201
Yanıt 201
Başlıklar
Content-Type: application/jsonLink: <http:/api.prodsmart.com/api/authorizations>;rel="self"
Gövde
{ "_links": { "self": { "href": "/api/authorizations" }, }, "scopes": [ "productions_write" ], "token": "abc123"}
Yetkilendirmeyi Kaldırma
SİL /api/authorization
Örnek URI
SİL /api/yetkilendirme
İstek
İstek
Başlıklar
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Yanıt 204
Yanıt 204