Cari oluştur

curl --request POST \
  --url https://api.noyax.com/api/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-CompanyID: <x-companyid>' \
  --header 'X-UserID: <x-userid>' \
  --data '
{
  "CustomerCode": "0000382026",
  "Name": "Örnek Ticaret A.Ş.",
  "TaxNumber": "1234567890",
  "TaxOffice": "Kadıköy",
  "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
  "Note": "Deliveries on weekdays only.",
  "DueDays": 30,
  "DiscountRate": 5,
  "Blacklisted": false,
  "MovementType": 2,
  "RiskLimit": 250000,
  "RiskControl": 1,
  "RiskAction": 1,
  "EInvoiceUser": true,
  "EInvoiceScenario": 1,
  "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ShowNoteOnQuote": false,
  "ShowNoteOnOrder": false,
  "ShowNoteOnWaybill": true,
  "ShowNoteOnInvoice": false,
  "IdentitySchemes": [
    {
      "SchemeID": "MERSISNO",
      "Value": "0123456789000015"
    }
  ],
  "Addresses": [
    {
      "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Address": "Caferağa Mah. Moda Cad. No: 10",
      "PostalCode": "34710",
      "IsInvoiceAddress": true,
      "CoordinateX": 40.9877,
      "CoordinateY": 29.0254
    }
  ],
  "Telephones": [
    {
      "Number": "02165550000",
      "NumberType": 1,
      "Extension": "101",
      "Description": "Accounting"
    }
  ],
  "Links": [
    {
      "Value": "[email protected]",
      "LinkType": 1,
      "Description": "Invoices"
    }
  ],
  "Representatives": [
    {
      "FullName": "Ayşe Yılmaz",
      "Position": "Purchasing Manager",
      "Gsm": "05325550000",
      "Email": "[email protected]",
      "Phone": "02165550000",
      "Extension": "105",
      "Link": "https://www.linkedin.com/in/example",
      "Description": "<string>"
    }
  ],
  "BankAccounts": [
    {
      "BankName": "Example Bank",
      "Branch": "Kadıköy",
      "AccountNumber": "12345678",
      "Iban": "TR330006100519786457841326",
      "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Description": "<string>"
    }
  ],
  "GroupMembers": [
    {
      "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "Parameters": [
    {
      "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Value": "Priority"
    }
  ],
  "QueryEInvoiceLabels": true
}
'

using RestSharp;


var options = new RestClientOptions("https://api.noyax.com/api/v1/customers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"CustomerCode\": \"0000382026\",\n  \"Name\": \"Örnek Ticaret A.Ş.\",\n  \"TaxNumber\": \"1234567890\",\n  \"TaxOffice\": \"Kadıköy\",\n  \"InvoiceTitle\": \"Örnek Ticaret Anonim Şirketi\",\n  \"Note\": \"Deliveries on weekdays only.\",\n  \"DueDays\": 30,\n  \"DiscountRate\": 5,\n  \"Blacklisted\": false,\n  \"MovementType\": 2,\n  \"RiskLimit\": 250000,\n  \"RiskControl\": 1,\n  \"RiskAction\": 1,\n  \"EInvoiceUser\": true,\n  \"EInvoiceScenario\": 1,\n  \"ShipmentDefinitionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"SharingCodeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"ShowNoteOnQuote\": false,\n  \"ShowNoteOnOrder\": false,\n  \"ShowNoteOnWaybill\": true,\n  \"ShowNoteOnInvoice\": false,\n  \"IdentitySchemes\": [\n    {\n      \"SchemeID\": \"MERSISNO\",\n      \"Value\": \"0123456789000015\"\n    }\n  ],\n  \"Addresses\": [\n    {\n      \"DistrictId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Address\": \"Caferağa Mah. Moda Cad. No: 10\",\n      \"PostalCode\": \"34710\",\n      \"IsInvoiceAddress\": true,\n      \"CoordinateX\": 40.9877,\n      \"CoordinateY\": 29.0254\n    }\n  ],\n  \"Telephones\": [\n    {\n      \"Number\": \"02165550000\",\n      \"NumberType\": 1,\n      \"Extension\": \"101\",\n      \"Description\": \"Accounting\"\n    }\n  ],\n  \"Links\": [\n    {\n      \"Value\": \"[email protected]\",\n      \"LinkType\": 1,\n      \"Description\": \"Invoices\"\n    }\n  ],\n  \"Representatives\": [\n    {\n      \"FullName\": \"Ayşe Yılmaz\",\n      \"Position\": \"Purchasing Manager\",\n      \"Gsm\": \"05325550000\",\n      \"Email\": \"[email protected]\",\n      \"Phone\": \"02165550000\",\n      \"Extension\": \"105\",\n      \"Link\": \"https://www.linkedin.com/in/example\",\n      \"Description\": \"<string>\"\n    }\n  ],\n  \"BankAccounts\": [\n    {\n      \"BankName\": \"Example Bank\",\n      \"Branch\": \"Kadıköy\",\n      \"AccountNumber\": \"12345678\",\n      \"Iban\": \"TR330006100519786457841326\",\n      \"CurrencyId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Description\": \"<string>\"\n    }\n  ],\n  \"GroupMembers\": [\n    {\n      \"GroupDetailId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"Parameters\": [\n    {\n      \"ParameterDefinitionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Value\": \"Priority\"\n    }\n  ],\n  \"QueryEInvoiceLabels\": true\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {
    'X-UserID': '<x-userid>',
    'X-CompanyID': '<x-companyid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    CustomerCode: '0000382026',
    Name: 'Örnek Ticaret A.Ş.',
    TaxNumber: '1234567890',
    TaxOffice: 'Kadıköy',
    InvoiceTitle: 'Örnek Ticaret Anonim Şirketi',
    Note: 'Deliveries on weekdays only.',
    DueDays: 30,
    DiscountRate: 5,
    Blacklisted: false,
    MovementType: 2,
    RiskLimit: 250000,
    RiskControl: 1,
    RiskAction: 1,
    EInvoiceUser: true,
    EInvoiceScenario: 1,
    ShipmentDefinitionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    SharingCodeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    ShowNoteOnQuote: false,
    ShowNoteOnOrder: false,
    ShowNoteOnWaybill: true,
    ShowNoteOnInvoice: false,
    IdentitySchemes: [{SchemeID: 'MERSISNO', Value: '0123456789000015'}],
    Addresses: [
      {
        DistrictId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Address: 'Caferağa Mah. Moda Cad. No: 10',
        PostalCode: '34710',
        IsInvoiceAddress: true,
        CoordinateX: 40.9877,
        CoordinateY: 29.0254
      }
    ],
    Telephones: [
      {
        Number: '02165550000',
        NumberType: 1,
        Extension: '101',
        Description: 'Accounting'
      }
    ],
    Links: [{Value: '[email protected]', LinkType: 1, Description: 'Invoices'}],
    Representatives: [
      {
        FullName: 'Ayşe Yılmaz',
        Position: 'Purchasing Manager',
        Gsm: '05325550000',
        Email: '[email protected]',
        Phone: '02165550000',
        Extension: '105',
        Link: 'https://www.linkedin.com/in/example',
        Description: '<string>'
      }
    ],
    BankAccounts: [
      {
        BankName: 'Example Bank',
        Branch: 'Kadıköy',
        AccountNumber: '12345678',
        Iban: 'TR330006100519786457841326',
        CurrencyId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Description: '<string>'
      }
    ],
    GroupMembers: [{GroupDetailId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    Parameters: [
      {
        ParameterDefinitionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Value: 'Priority'
      }
    ],
    QueryEInvoiceLabels: true
  })
};

fetch('https://api.noyax.com/api/v1/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.noyax.com/api/v1/customers"

payload = {
    "CustomerCode": "0000382026",
    "Name": "Örnek Ticaret A.Ş.",
    "TaxNumber": "1234567890",
    "TaxOffice": "Kadıköy",
    "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
    "Note": "Deliveries on weekdays only.",
    "DueDays": 30,
    "DiscountRate": 5,
    "Blacklisted": False,
    "MovementType": 2,
    "RiskLimit": 250000,
    "RiskControl": 1,
    "RiskAction": 1,
    "EInvoiceUser": True,
    "EInvoiceScenario": 1,
    "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ShowNoteOnQuote": False,
    "ShowNoteOnOrder": False,
    "ShowNoteOnWaybill": True,
    "ShowNoteOnInvoice": False,
    "IdentitySchemes": [
        {
            "SchemeID": "MERSISNO",
            "Value": "0123456789000015"
        }
    ],
    "Addresses": [
        {
            "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Address": "Caferağa Mah. Moda Cad. No: 10",
            "PostalCode": "34710",
            "IsInvoiceAddress": True,
            "CoordinateX": 40.9877,
            "CoordinateY": 29.0254
        }
    ],
    "Telephones": [
        {
            "Number": "02165550000",
            "NumberType": 1,
            "Extension": "101",
            "Description": "Accounting"
        }
    ],
    "Links": [
        {
            "Value": "[email protected]",
            "LinkType": 1,
            "Description": "Invoices"
        }
    ],
    "Representatives": [
        {
            "FullName": "Ayşe Yılmaz",
            "Position": "Purchasing Manager",
            "Gsm": "05325550000",
            "Email": "[email protected]",
            "Phone": "02165550000",
            "Extension": "105",
            "Link": "https://www.linkedin.com/in/example",
            "Description": "<string>"
        }
    ],
    "BankAccounts": [
        {
            "BankName": "Example Bank",
            "Branch": "Kadıköy",
            "AccountNumber": "12345678",
            "Iban": "TR330006100519786457841326",
            "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Description": "<string>"
        }
    ],
    "GroupMembers": [{ "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "Parameters": [
        {
            "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Value": "Priority"
        }
    ],
    "QueryEInvoiceLabels": True
}
headers = {
    "X-UserID": "<x-userid>",
    "X-CompanyID": "<x-companyid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "Success": true,
  "ResultCode": "0000",
  "Data": {
    "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerCode": "0000382026",
    "Name": "Örnek Ticaret A.Ş.",
    "TaxNumber": "1234567890",
    "TaxOffice": "Kadıköy",
    "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
    "Note": "Deliveries on weekdays only.",
    "DueDays": 30,
    "DiscountRate": 5,
    "Blacklisted": false,
    "MovementType": 2,
    "RiskLimit": 250000,
    "RiskControl": 1,
    "RiskAction": 1,
    "EInvoiceUser": true,
    "EInvoiceScenario": 1,
    "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ShowNoteOnQuote": false,
    "ShowNoteOnOrder": false,
    "ShowNoteOnWaybill": true,
    "ShowNoteOnInvoice": false,
    "IdentitySchemes": [
      {
        "SchemeID": "MERSISNO",
        "Value": "0123456789000015"
      }
    ],
    "CreateDate": "2023-11-07T05:31:56Z",
    "ModifyDate": "2023-11-07T05:31:56Z",
    "Addresses": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "DistrictName": "Kadıköy",
        "CityName": "İstanbul",
        "CountryName": "Türkiye",
        "Address": "Caferağa Mah. Moda Cad. No: 10",
        "FullAddress": "<string>",
        "PostalCode": "34710",
        "IsInvoiceAddress": true,
        "CoordinateX": 40.9877,
        "CoordinateY": 29.0254
      }
    ],
    "Telephones": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Number": "02165550000",
        "NumberType": 1,
        "Extension": "101",
        "Description": "Accounting"
      }
    ],
    "Links": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Value": "[email protected]",
        "LinkType": 1,
        "Description": "Invoices"
      }
    ],
    "Representatives": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "FullName": "Ayşe Yılmaz",
        "Position": "Purchasing Manager",
        "Gsm": "05325550000",
        "Email": "[email protected]",
        "Phone": "02165550000",
        "Extension": "105",
        "Link": "https://www.linkedin.com/in/example",
        "Description": "<string>"
      }
    ],
    "BankAccounts": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CurrencyName": "TL",
        "BankName": "Example Bank",
        "Branch": "Kadıköy",
        "AccountNumber": "12345678",
        "Iban": "TR330006100519786457841326",
        "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Description": "<string>"
      }
    ],
    "GroupMembers": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupDetailName": "Marmara",
        "GroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupName": "Region"
      }
    ],
    "Parameters": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "ParameterName": "Segment",
        "ParameterType": 0,
        "Value": "Priority"
      }
    ],
    "EInvoiceLabels": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Label": "urn:mail:[email protected]",
        "Description": "ÖRNEK TİCARET A.Ş.",
        "Type": 0,
        "IsDefault": true
      }
    ]
  },
  "Message": "<string>"
}

{
  "Success": false,
  "ResultCode": "1004",
  "Message": "Name is required.",
  "Errors": [
    {
      "Code": "1004",
      "Message": "Name is required."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0102",
  "Message": "Token has expired. Obtain a new token using the refresh token.",
  "Errors": [
    {
      "Code": "0102",
      "Message": "Token has expired. Obtain a new token using the refresh token."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0110",
  "Message": "You do not have permission for this operation.",
  "Errors": [
    {
      "Code": "0110",
      "Message": "You do not have permission for this operation."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0120",
  "Message": "Daily request limit (10000) exceeded.",
  "Errors": [
    {
      "Code": "0120",
      "Message": "Daily request limit (10000) exceeded."
    }
  ]
}

POST

api

customers

Cari oluştur

curl --request POST \
  --url https://api.noyax.com/api/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-CompanyID: <x-companyid>' \
  --header 'X-UserID: <x-userid>' \
  --data '
{
  "CustomerCode": "0000382026",
  "Name": "Örnek Ticaret A.Ş.",
  "TaxNumber": "1234567890",
  "TaxOffice": "Kadıköy",
  "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
  "Note": "Deliveries on weekdays only.",
  "DueDays": 30,
  "DiscountRate": 5,
  "Blacklisted": false,
  "MovementType": 2,
  "RiskLimit": 250000,
  "RiskControl": 1,
  "RiskAction": 1,
  "EInvoiceUser": true,
  "EInvoiceScenario": 1,
  "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ShowNoteOnQuote": false,
  "ShowNoteOnOrder": false,
  "ShowNoteOnWaybill": true,
  "ShowNoteOnInvoice": false,
  "IdentitySchemes": [
    {
      "SchemeID": "MERSISNO",
      "Value": "0123456789000015"
    }
  ],
  "Addresses": [
    {
      "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Address": "Caferağa Mah. Moda Cad. No: 10",
      "PostalCode": "34710",
      "IsInvoiceAddress": true,
      "CoordinateX": 40.9877,
      "CoordinateY": 29.0254
    }
  ],
  "Telephones": [
    {
      "Number": "02165550000",
      "NumberType": 1,
      "Extension": "101",
      "Description": "Accounting"
    }
  ],
  "Links": [
    {
      "Value": "[email protected]",
      "LinkType": 1,
      "Description": "Invoices"
    }
  ],
  "Representatives": [
    {
      "FullName": "Ayşe Yılmaz",
      "Position": "Purchasing Manager",
      "Gsm": "05325550000",
      "Email": "[email protected]",
      "Phone": "02165550000",
      "Extension": "105",
      "Link": "https://www.linkedin.com/in/example",
      "Description": "<string>"
    }
  ],
  "BankAccounts": [
    {
      "BankName": "Example Bank",
      "Branch": "Kadıköy",
      "AccountNumber": "12345678",
      "Iban": "TR330006100519786457841326",
      "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Description": "<string>"
    }
  ],
  "GroupMembers": [
    {
      "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "Parameters": [
    {
      "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "Value": "Priority"
    }
  ],
  "QueryEInvoiceLabels": true
}
'

using RestSharp;


var options = new RestClientOptions("https://api.noyax.com/api/v1/customers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"CustomerCode\": \"0000382026\",\n  \"Name\": \"Örnek Ticaret A.Ş.\",\n  \"TaxNumber\": \"1234567890\",\n  \"TaxOffice\": \"Kadıköy\",\n  \"InvoiceTitle\": \"Örnek Ticaret Anonim Şirketi\",\n  \"Note\": \"Deliveries on weekdays only.\",\n  \"DueDays\": 30,\n  \"DiscountRate\": 5,\n  \"Blacklisted\": false,\n  \"MovementType\": 2,\n  \"RiskLimit\": 250000,\n  \"RiskControl\": 1,\n  \"RiskAction\": 1,\n  \"EInvoiceUser\": true,\n  \"EInvoiceScenario\": 1,\n  \"ShipmentDefinitionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"SharingCodeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"ShowNoteOnQuote\": false,\n  \"ShowNoteOnOrder\": false,\n  \"ShowNoteOnWaybill\": true,\n  \"ShowNoteOnInvoice\": false,\n  \"IdentitySchemes\": [\n    {\n      \"SchemeID\": \"MERSISNO\",\n      \"Value\": \"0123456789000015\"\n    }\n  ],\n  \"Addresses\": [\n    {\n      \"DistrictId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Address\": \"Caferağa Mah. Moda Cad. No: 10\",\n      \"PostalCode\": \"34710\",\n      \"IsInvoiceAddress\": true,\n      \"CoordinateX\": 40.9877,\n      \"CoordinateY\": 29.0254\n    }\n  ],\n  \"Telephones\": [\n    {\n      \"Number\": \"02165550000\",\n      \"NumberType\": 1,\n      \"Extension\": \"101\",\n      \"Description\": \"Accounting\"\n    }\n  ],\n  \"Links\": [\n    {\n      \"Value\": \"[email protected]\",\n      \"LinkType\": 1,\n      \"Description\": \"Invoices\"\n    }\n  ],\n  \"Representatives\": [\n    {\n      \"FullName\": \"Ayşe Yılmaz\",\n      \"Position\": \"Purchasing Manager\",\n      \"Gsm\": \"05325550000\",\n      \"Email\": \"[email protected]\",\n      \"Phone\": \"02165550000\",\n      \"Extension\": \"105\",\n      \"Link\": \"https://www.linkedin.com/in/example\",\n      \"Description\": \"<string>\"\n    }\n  ],\n  \"BankAccounts\": [\n    {\n      \"BankName\": \"Example Bank\",\n      \"Branch\": \"Kadıköy\",\n      \"AccountNumber\": \"12345678\",\n      \"Iban\": \"TR330006100519786457841326\",\n      \"CurrencyId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Description\": \"<string>\"\n    }\n  ],\n  \"GroupMembers\": [\n    {\n      \"GroupDetailId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"Parameters\": [\n    {\n      \"ParameterDefinitionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"Value\": \"Priority\"\n    }\n  ],\n  \"QueryEInvoiceLabels\": true\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {
    'X-UserID': '<x-userid>',
    'X-CompanyID': '<x-companyid>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    CustomerCode: '0000382026',
    Name: 'Örnek Ticaret A.Ş.',
    TaxNumber: '1234567890',
    TaxOffice: 'Kadıköy',
    InvoiceTitle: 'Örnek Ticaret Anonim Şirketi',
    Note: 'Deliveries on weekdays only.',
    DueDays: 30,
    DiscountRate: 5,
    Blacklisted: false,
    MovementType: 2,
    RiskLimit: 250000,
    RiskControl: 1,
    RiskAction: 1,
    EInvoiceUser: true,
    EInvoiceScenario: 1,
    ShipmentDefinitionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    SharingCodeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    ShowNoteOnQuote: false,
    ShowNoteOnOrder: false,
    ShowNoteOnWaybill: true,
    ShowNoteOnInvoice: false,
    IdentitySchemes: [{SchemeID: 'MERSISNO', Value: '0123456789000015'}],
    Addresses: [
      {
        DistrictId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Address: 'Caferağa Mah. Moda Cad. No: 10',
        PostalCode: '34710',
        IsInvoiceAddress: true,
        CoordinateX: 40.9877,
        CoordinateY: 29.0254
      }
    ],
    Telephones: [
      {
        Number: '02165550000',
        NumberType: 1,
        Extension: '101',
        Description: 'Accounting'
      }
    ],
    Links: [{Value: '[email protected]', LinkType: 1, Description: 'Invoices'}],
    Representatives: [
      {
        FullName: 'Ayşe Yılmaz',
        Position: 'Purchasing Manager',
        Gsm: '05325550000',
        Email: '[email protected]',
        Phone: '02165550000',
        Extension: '105',
        Link: 'https://www.linkedin.com/in/example',
        Description: '<string>'
      }
    ],
    BankAccounts: [
      {
        BankName: 'Example Bank',
        Branch: 'Kadıköy',
        AccountNumber: '12345678',
        Iban: 'TR330006100519786457841326',
        CurrencyId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Description: '<string>'
      }
    ],
    GroupMembers: [{GroupDetailId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    Parameters: [
      {
        ParameterDefinitionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        Value: 'Priority'
      }
    ],
    QueryEInvoiceLabels: true
  })
};

fetch('https://api.noyax.com/api/v1/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.noyax.com/api/v1/customers"

payload = {
    "CustomerCode": "0000382026",
    "Name": "Örnek Ticaret A.Ş.",
    "TaxNumber": "1234567890",
    "TaxOffice": "Kadıköy",
    "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
    "Note": "Deliveries on weekdays only.",
    "DueDays": 30,
    "DiscountRate": 5,
    "Blacklisted": False,
    "MovementType": 2,
    "RiskLimit": 250000,
    "RiskControl": 1,
    "RiskAction": 1,
    "EInvoiceUser": True,
    "EInvoiceScenario": 1,
    "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ShowNoteOnQuote": False,
    "ShowNoteOnOrder": False,
    "ShowNoteOnWaybill": True,
    "ShowNoteOnInvoice": False,
    "IdentitySchemes": [
        {
            "SchemeID": "MERSISNO",
            "Value": "0123456789000015"
        }
    ],
    "Addresses": [
        {
            "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Address": "Caferağa Mah. Moda Cad. No: 10",
            "PostalCode": "34710",
            "IsInvoiceAddress": True,
            "CoordinateX": 40.9877,
            "CoordinateY": 29.0254
        }
    ],
    "Telephones": [
        {
            "Number": "02165550000",
            "NumberType": 1,
            "Extension": "101",
            "Description": "Accounting"
        }
    ],
    "Links": [
        {
            "Value": "[email protected]",
            "LinkType": 1,
            "Description": "Invoices"
        }
    ],
    "Representatives": [
        {
            "FullName": "Ayşe Yılmaz",
            "Position": "Purchasing Manager",
            "Gsm": "05325550000",
            "Email": "[email protected]",
            "Phone": "02165550000",
            "Extension": "105",
            "Link": "https://www.linkedin.com/in/example",
            "Description": "<string>"
        }
    ],
    "BankAccounts": [
        {
            "BankName": "Example Bank",
            "Branch": "Kadıköy",
            "AccountNumber": "12345678",
            "Iban": "TR330006100519786457841326",
            "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Description": "<string>"
        }
    ],
    "GroupMembers": [{ "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "Parameters": [
        {
            "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "Value": "Priority"
        }
    ],
    "QueryEInvoiceLabels": True
}
headers = {
    "X-UserID": "<x-userid>",
    "X-CompanyID": "<x-companyid>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "Success": true,
  "ResultCode": "0000",
  "Data": {
    "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "CustomerCode": "0000382026",
    "Name": "Örnek Ticaret A.Ş.",
    "TaxNumber": "1234567890",
    "TaxOffice": "Kadıköy",
    "InvoiceTitle": "Örnek Ticaret Anonim Şirketi",
    "Note": "Deliveries on weekdays only.",
    "DueDays": 30,
    "DiscountRate": 5,
    "Blacklisted": false,
    "MovementType": 2,
    "RiskLimit": 250000,
    "RiskControl": 1,
    "RiskAction": 1,
    "EInvoiceUser": true,
    "EInvoiceScenario": 1,
    "ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "SharingCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ShowNoteOnQuote": false,
    "ShowNoteOnOrder": false,
    "ShowNoteOnWaybill": true,
    "ShowNoteOnInvoice": false,
    "IdentitySchemes": [
      {
        "SchemeID": "MERSISNO",
        "Value": "0123456789000015"
      }
    ],
    "CreateDate": "2023-11-07T05:31:56Z",
    "ModifyDate": "2023-11-07T05:31:56Z",
    "Addresses": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "DistrictName": "Kadıköy",
        "CityName": "İstanbul",
        "CountryName": "Türkiye",
        "Address": "Caferağa Mah. Moda Cad. No: 10",
        "FullAddress": "<string>",
        "PostalCode": "34710",
        "IsInvoiceAddress": true,
        "CoordinateX": 40.9877,
        "CoordinateY": 29.0254
      }
    ],
    "Telephones": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Number": "02165550000",
        "NumberType": 1,
        "Extension": "101",
        "Description": "Accounting"
      }
    ],
    "Links": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Value": "[email protected]",
        "LinkType": 1,
        "Description": "Invoices"
      }
    ],
    "Representatives": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "FullName": "Ayşe Yılmaz",
        "Position": "Purchasing Manager",
        "Gsm": "05325550000",
        "Email": "[email protected]",
        "Phone": "02165550000",
        "Extension": "105",
        "Link": "https://www.linkedin.com/in/example",
        "Description": "<string>"
      }
    ],
    "BankAccounts": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CurrencyName": "TL",
        "BankName": "Example Bank",
        "Branch": "Kadıköy",
        "AccountNumber": "12345678",
        "Iban": "TR330006100519786457841326",
        "CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Description": "<string>"
      }
    ],
    "GroupMembers": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupDetailName": "Marmara",
        "GroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "GroupName": "Region"
      }
    ],
    "Parameters": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "ParameterDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "ParameterName": "Segment",
        "ParameterType": 0,
        "Value": "Priority"
      }
    ],
    "EInvoiceLabels": [
      {
        "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "Label": "urn:mail:[email protected]",
        "Description": "ÖRNEK TİCARET A.Ş.",
        "Type": 0,
        "IsDefault": true
      }
    ]
  },
  "Message": "<string>"
}

{
  "Success": false,
  "ResultCode": "1004",
  "Message": "Name is required.",
  "Errors": [
    {
      "Code": "1004",
      "Message": "Name is required."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0102",
  "Message": "Token has expired. Obtain a new token using the refresh token.",
  "Errors": [
    {
      "Code": "0102",
      "Message": "Token has expired. Obtain a new token using the refresh token."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0110",
  "Message": "You do not have permission for this operation.",
  "Errors": [
    {
      "Code": "0110",
      "Message": "You do not have permission for this operation."
    }
  ]
}

{
  "Success": false,
  "ResultCode": "0120",
  "Message": "Daily request limit (10000) exceeded.",
  "Errors": [
    {
      "Code": "0120",
      "Message": "Daily request limit (10000) exceeded."
    }
  ]
}

Cari ve gönderilen tüm alt kayıtlar tek transaction içinde yazılır: herhangi bir kayıt hatalıysa hiçbir şey kaydedilmez ve tüm hatalar tek Message içinde döner.

Alan kuralları

Zorunlu alanlar, risk, e-fatura ve not kuralları.

Alt kayıtlar

Adres, telefon, banka, grup ve parametre kuralları.

CustomerCode alanına "Next" gönderirseniz kod, şirketin cari numarası serisinden otomatik üretilir. Bkz. Cari kodu üretimi.

İhtiyacınız olmayan alt kayıt listelerini boş dizi ([]) olarak gönderin. Başarılı yanıt 201 Created ile döner ve Location header’ı yeni carinin adresini içerir.

Yetkilendirmeler

Authorization

string

header

gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID

integer<int32>

gerekli

İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır.

Gerekli aralık: x >= 1

X-CompanyID

integer<int32>

gerekli

Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır.

Gerekli aralık: x >= 1

X-PeriodID

integer<int32>

Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Gövde

CustomerCode

null | string

Zorunlu. Şirket içinde benzersizdir. Oluştururken "Next" gönderirseniz kod, şirketin cari numarası serisinden üretilir.

Örnek:

"0000382026"

Name

null | string

Zorunlu. Cari adı.

Örnek:

"Örnek Ticaret A.Ş."

TaxNumber

null | string

Zorunlu. Yalnızca rakam: 10 haneli vergi kimlik numarası (VKN) ya da 11 haneli T.C. kimlik numarası (TCKN).

Örnek:

"1234567890"

TaxOffice

null | string

Vergi dairesi adı.

Örnek:

"Kadıköy"

InvoiceTitle

null | string

Faturalarda kullanılan ünvan. Boş bırakılırsa Name alanı kullanılır.

Örnek:

"Örnek Ticaret Anonim Şirketi"

Note

null | string

Serbest metin not. ShowNoteOn* alanlarından biri true ise zorunludur.

Örnek:

"Deliveries on weekdays only."

DueDays

integer<int32>

Gün olarak vade. 0'dan küçük olamaz.

Örnek:

30

DiscountRate

number<double>

Varsayılan iskonto oranı (%), 0 ile 100 arasında.

Örnek:

5

Blacklisted

boolean

Cariyi kara listeye alır.

Örnek:

false

MovementType

integer<int32>

1: Satıcı, 2: Alıcı, 3: Satıcı ve alıcı. 0 gönderilirse 1 olarak kaydedilir.

Örnek:

2

RiskLimit

number<double>

Risk limiti tutarı. 0'dan küçük olamaz. 0, risk limiti yok demektir.

Örnek:

250000

RiskControl

integer<int32>

Risk limitinin nasıl kontrol edileceği. 1: Mevcut bakiye, 2: Satış tutarı. RiskLimit 0'dan büyükse 1 ya da 2 olmalıdır.

Örnek:

1

RiskAction

integer<int32>

Risk limiti aşıldığında ne olacağı. 0: Devam et, 1: Kullanıcıyı uyar, 2: İşlemi durdur.

Örnek:

1

EInvoiceUser

boolean

Carinin e-fatura mükellefi olup olmadığı.

Örnek:

true

EInvoiceScenario

integer<int32>

E-fatura senaryosu. EInvoiceUser true ise 1-9, değilse 0 olmalıdır. 1: Ticari, 2: Temel, 3: İhracat, 4: Kamu, 5: HKS, 6: Enerji, 7: İlaç/Tıbbi cihaz, 8: Yatırım teşvik, 9: IDIS.

Örnek:

1

ShipmentDefinitionId

null | string<uuid>

GET /api/v1/definitions/shipment-definitions ile dönen bir sevkiyat tanımının ID'si.

Cariyi kimlerin görebileceğini sınırlayan paylaşım kodu. Boş bırakılırsa herkes görür; doldurulursa kullanıcının paylaşım kodlarından biri olmalıdır.

ShowNoteOnQuote

boolean

Notu tekliflerde göster.

Örnek:

false

ShowNoteOnOrder

boolean

Notu siparişlerde göster.

Örnek:

false

ShowNoteOnWaybill

boolean

Notu irsaliyelerde göster.

Örnek:

true

ShowNoteOnInvoice

boolean

Notu faturalarda göster.

Örnek:

false

IdentitySchemes

object[]

Ek kimlik numaraları (ör. MERSISNO). Her SchemeID yalnızca bir kez gönderilebilir.

Show child attributes

Addresses

object[]

Adresler. Birden fazla gönderilirse tam olarak biri fatura adresi olmalıdır. Tek adres gönderilirse o adres fatura adresi olur.

Show child attributes

Telephones

object[]

Telefon numaraları.

Show child attributes

Links

object[]

E-posta adresleri, web siteleri ve sosyal medya linkleri.

Show child attributes

Representatives

object[]

Yetkili kişiler.

Show child attributes

BankAccounts

object[]

Banka hesapları.

Show child attributes

GroupMembers

object[]

Grup üyelikleri. Zorunlu her gruptan en az bir detay gönderilmelidir.

Show child attributes

Parameters

object[]

Özel parametre değerleri.

Show child attributes

QueryEInvoiceLabels

boolean

true gönderilirse cari kaydedildikten sonra e-fatura etiketleri entegratörden sorgulanır. Sorgu başarısız olsa bile cari oluşmuş kalır.

Örnek:

true

Yanıt

Created

Success

boolean

gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode

string

gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data

object

gerekli

Response data. Null when Success is false.

Show child attributes

Message

null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.

Başlarken

Temel kavramlar

Modüller

Sürüm notları

Cari oluştur

Alan kuralları

Alt kayıtlar

Yetkilendirmeler

Başlıklar

Gövde

Yanıt