Turkey

Invoice

Changes to generic fields

recipient.address.line1 is required
recipient.address.city is required
recipient.address.state is required
recipient.address.postalCode is required
recipient.address.country is required
recipient.customInfo.tur.eFaturaRegistered is required.
customInfo.tur.profileId is required.
customInfo.tur.invoiceTypeCode is required.
Only invoices issued as Commercial invoices (customInfo.tur.profileId = Commercial) can be credited, within 8 days of issuance).

type Invoice {
// ...all generic invoice fields
  notes?: string;
  transactionType?: 'B2C' | 'B2B'
  lines: [
    { 
      // ..other line item fields
      unit:sting;
      vat: {
      // ...other line item vat fields
        code: string;
        exemptReason?:string;
        exemptReasonCode?: string;
      };
    };
  ];
  recipient: {
    // ...everything from invoice.recipient,
    address:{
      line1: string;
      line2?: string;
      city: string;
      state?: string;
      postalCode?: string;
      country: string;
    };
    contact?: {
      name?: string;
      phone?: string;
      email?: string;
    };
    customInfo:{
      tur:{
        taxOffice?: string;
        idScheme?: string;
        eFaturaRegistered: boolean;
      };
    };
   };
  customInfo: {
    tur: {
      profileId: string;
      invoiceTypeCode:string;
    };
   };
};

Field information

Name	Type	Required	Description
`transactionType`	string	No	Value describing the transaction. A value from a list: B2C \| B2B
`notes`	string	No	Any applicable or additional notes
`lines[].vat.code`	string	Required	Standard VAT codes. A value from an enumerated list as outlined below: S: Standard E: Exempt Z: Zero rated AE: Reverse charge O: Outside of scope
`lines[].vat.exemptReason`	string	Conditional	If the VAT Amount is 0, a value is required
`lines[].vat.exemptReasonCode`	string	Conditional	If the VAT Amount is 0, a value from a list must be chosen. Turkey Exempt Reason Codes
`lines[].unitCode`	string	No	A specific value from an enumerated list as outlined on Turkish units of measure
`recipient.address.country`	string	Required	Three-letter country code (ISO 3166).
`recipient.address.city`	string	Required	City/District/Suburb/Town/Village
`recipient.contact.email`	string	No	Email address of recipient.
`recipient.customInfo.tur.taxOffice`	string	No	Recipients applicable tax office
`recipient.customInfo.tur.eFaturaRegistered`	boolean	Required	Indicates whether the domestic recipient is registered with the Turkish GiB. true: Recipient registered with the GiB (eFatura) false: Recipient not registered with the GiB (eArsiv). Note: For exports/non-domestic transactions this value must be true.
`recipient.customInfo.tur.idScheme`	string	No	A value indicating the identification number type of the recipient. A value from a list: VKN: Tax identification number used for individuals, businesses, and foreign entities for tax purposes. TCKN: Personal identification number for Turkish citizens.
`customInfo.tur.profileId`	string	Required	Invoice profile ID. A value from an enumerated list: Basic: Indicates the Basic Invoice process. Commercial: Indicates the Commercial Invoice process. eArchive: Indicates the E-Archive (e-Arsiv) Invoice process. Export: Indicates the Export Invoice process.
`customInfo.tur.invoiceTypeCode`	string	Required	Code specifying the type of the Invoice. Sales: Used for invoices issued for all kinds of goods and services sales. Exempt: Used for invoices that include tax exemption. Exempt code options: Special: Used for special tax base invoices. Exempt code options. ExportRegistered: Used for invoices issued for export-registered sales and sales within the scope of the Inward Processing Authorization Certificate (DİİB) and the temporary admission regime. Note: For exports/non-domestic transactions `customInfo.tur.invoiceTypeCode` must be Exempt or Special and the corresponding `lines[].vat.exemptReasonCode`must be used.

Example CSV file

Invoice - tur.csv