Fatura Oluşturma

Önemli Bilgi

Fatura resmi olarak gönderilene kadar tarafınızdan gönderilen body.document.External.ID ve body.document.External.Type ile takip edilmektedir. Bu iki bilgi birlikte benzersiz olmalıdır.

Örnek olarak ID: 1234 ve Type: Müthiş Entegre App olarak fatura oluşturulduğunda, tekrar bu iki değer gönderilerek başka bir fatura oluşturulamaz.

TIP

Önerilen kullanım şekli olarak Type bilgisini sabit tutup, ID bilgisini değiştirilerek gönderilmesidir. Çünkü Type bilgisi belge uygulaması üzerinde gözükmektedir ve buradan filtrelemeler yapılabilmektedir.

INFO

Eğer uygulamanızda dönem vs. gibi IDnin tekrar etmesini zorunlu kılan durumlar bulunuyor ise Type bilgisini Müthiş Entegre App:{dönem} şeklinde gönderebilirsiniz. Bu kullanımda farklı dönemler içerisinde aynı ID ile gönderilmiş olan belgeler çakışmayacaktır ve daha stabil bir kullanım sunulmuş olacaktır.

💡

Ayrıca Type bilgisi : işareti ile parse edilmektedir. Yani Müthiş Entegre App:{dönem} kullanımında belge uygulaması üzerinde sadece Müthiş Entegre App yazısı gözükecektir. Dönemin de gözükmesini isterseniz Müthiş Entegre App {dönem} gibi bir kullanım sağlayabilirsiniz.

DANGER

Fatura oluşturulduktan sonra response olarak dönen UUID bilgisini KESİNLİKLE saklayınız. Bu bilgi Dışarı Aktarma, İptal etme gibi resmi olan endpoinlerde talep edilecektir.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Example

{
    "draft": true,
    "document": {
        "External": {
            "ID": "string",
            "RefNo": "MEA11152",
            "Type": "Müthiş Entegre App"
        },
        "Type": "SATIS",
        "Profile": "TEMELFATURA",
        "NumberOrSerie": "RS",
        "UUID": "f50af7e0-0dd5-4361-ab96-2e04f7bc7e30",
        "IssueDateTime": "string",
        "Notes": [
            "string"
        ],
        "CurrencyCode": "TRY",
        "ExchangeRate": 0,
        "TaxExemptions": {
            "KDV": 322
        },
        "Order": {
            "Date": "2023-10-19",
            "Value": "SIP0001"
        },
        "Despatches": [
            {
                "Date": "2023-10-19",
                "Value": "IRS0001"
            }
        ],
        "Customer": {
            "TaxNumber": "string",
            "TaxOffice": "string",
            "Name": "string",
            "Alias": "string",
            "Address": "string",
            "District": "string",
            "City": "string",
            "Country": "string",
            "PostalCode": "strin",
            "Phone": "string",
            "Fax": "string",
            "Mail": "string",
            "Website": "string"
        },
        "BuyerCustomer": {
            "TaxNumber": "string",
            "TaxOffice": "string",
            "Name": "string",
            "Address": "string",
            "District": "string",
            "City": "string",
            "Country": "string",
            "PostalCode": "strin",
            "Phone": "string",
            "Fax": "string",
            "Mail": "string",
            "Website": "string"
        },
        "PaymentMeans": {
            "DueDate": "string",
            "ChannelCode": "string",
            "AccountNumber": "string",
            "PaymentNote": "string",
            "MeansCode": "string"
        },
        "SGK": {
            "Type": "string",
            "CompCode": "string",
            "CompName": "string",
            "DocNo": "string",
            "StartDate": "string",
            "EndDate": "string"
        },
        "Lines": [
            {
                "Name": "Örnek mal hizmet adı",
                "Quantity": 19.1,
                "UnitCode": "ADET",
                "Price": 19.05,
                "KDV": {
                    "Percent": 0,
                    "Amount": 0
                },
                "Allowance": {
                    "Percent": 20,
                    "Price": 0
                },
                "WithholdingTax": {
                    "Code": 621
                },
                "AdditionalNames": {
                    "Description": "string",
                    "Brand": "string",
                    "Model": "string",
                    "BuyerCode": "string",
                    "SellerCode": "string",
                    "ManufacturerCode": "string",
                    "Origin": "string",
                    "Note": "string"
                },
                "Taxes": [
                    {
                        "Percent": 20,
                        "Code": "0053"
                    }
                ]
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apidemo.rahatsistem.com.tr/v2/documents/invoice.create' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "draft": true,
    "document": {
        "External": {
            "ID": "string",
            "RefNo": "MEA11152",
            "Type": "Müthiş Entegre App"
        },
        "Type": "SATIS",
        "Profile": "TEMELFATURA",
        "NumberOrSerie": "RS",
        "UUID": "f50af7e0-0dd5-4361-ab96-2e04f7bc7e30",
        "IssueDateTime": "string",
        "Notes": [
            "string"
        ],
        "CurrencyCode": "TRY",
        "ExchangeRate": 0,
        "TaxExemptions": {
            "KDV": 322
        },
        "Order": {
            "Date": "2023-10-19",
            "Value": "SIP0001"
        },
        "Despatches": [
            {
                "Date": "2023-10-19",
                "Value": "IRS0001"
            }
        ],
        "Customer": {
            "TaxNumber": "string",
            "TaxOffice": "string",
            "Name": "string",
            "Alias": "string",
            "Address": "string",
            "District": "string",
            "City": "string",
            "Country": "string",
            "PostalCode": "strin",
            "Phone": "string",
            "Fax": "string",
            "Mail": "string",
            "Website": "string"
        },
        "BuyerCustomer": {
            "TaxNumber": "string",
            "TaxOffice": "string",
            "Name": "string",
            "Address": "string",
            "District": "string",
            "City": "string",
            "Country": "string",
            "PostalCode": "strin",
            "Phone": "string",
            "Fax": "string",
            "Mail": "string",
            "Website": "string"
        },
        "PaymentMeans": {
            "DueDate": "string",
            "ChannelCode": "string",
            "AccountNumber": "string",
            "PaymentNote": "string",
            "MeansCode": "string"
        },
        "SGK": {
            "Type": "string",
            "CompCode": "string",
            "CompName": "string",
            "DocNo": "string",
            "StartDate": "string",
            "EndDate": "string"
        },
        "Lines": [
            {
                "Name": "Örnek mal hizmet adı",
                "Quantity": 19.1,
                "UnitCode": "ADET",
                "Price": 19.05,
                "KDV": {
                    "Percent": 0,
                    "Amount": 0
                },
                "Allowance": {
                    "Percent": 20,
                    "Price": 0
                },
                "WithholdingTax": {
                    "Code": 621
                },
                "AdditionalNames": {
                    "Description": "string",
                    "Brand": "string",
                    "Model": "string",
                    "BuyerCode": "string",
                    "SellerCode": "string",
                    "ManufacturerCode": "string",
                    "Origin": "string",
                    "Note": "string"
                },
                "Taxes": [
                    {
                        "Percent": 20,
                        "Code": "0053"
                    }
                ]
            }
        ]
    }
}'

Önemli Bilgi#

Request

Request Code Samples

Responses

Önemli Bilgi