Pisano Müşteri CSV Aktarım Servisi Dokümantasyonu

API Bilgileri URL: /v1/customers/import_from_csv HTTP Method: POST İçerik Türü: application/json

Açıklama

Bu servis, Pisano sistemine müşteri bilgilerini CSV formatında aktarmak için kullanılır. Aktarım sırasında, CSV dosyasında bulunan sütunlar, Pisano müşteri şemasındaki ilgili alanlarla eşleştirilmelidir. Aşağıda verilen bilgiler örnektir body kısmı sizin hesap ve beslemek istediğiniz şema alanlarına göre değişecektir.

Header Bilgileri

Authorization: Kullanıcı entegrasyon token'ı
Content-type: application/json

Gönderilecek JSON Verisi (Body)

{

    "node_id": "<Pisano hesap ID>",

    "column_mapping": {

        "phone_number": "MOBILEPHONE",

        "external_id": "ID",

        "email": "EMAIL",

        "name": "NAME"

    },

    "csv_file": {

        "name": "customer_import_sample.csv",

        "csv_string": "MOBILEPHONE,EMAIL,NAME,ID,\r\n

        5555555555,pisano@pisano.com,Pisano,123"

    }

}




Parametre Açıklamaları

node_id: Pisano hesap ID’si (zorunlu)
column_mapping: CSV sütunlarının müşteri şeması ile eşleştirilmesi soldaki kısımlar pisano ortamındaki şema kodunu temsil eder sağdaki kısımlar csv dosyasındaki kolonu temsil eder
csv_file.name: Aktarılacak CSV dosyasının adı
csv_file.csv_string: CSV içeriği (birinci satır keyler, sonraki satırlar veridir)

column_mapping: Pisano ortamınızdaki beslemek istediğiniz şema alanlarına karşılık gelmektedir.

Başarılı Yanıt (Success Response)

Status Code: 200 OK
Açıklama: CSV içeriği başarıyla işlendi ve müşteriler sisteme aktarıldı.

Hata Yanıtları (Error Responses)

Status Code: 400 Bad Request
Açıklama: Hatalı veya eksik veri gönderildi.

Status Code: 401 Unauthorized
Açıklama: Geçersiz veya eksik yetkilendirme token’ı kullanıldı.