Turkey

Credit note

Changes to generic fields

invoiceRefs is required
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.
Credit notes can only be issued on AP (received) invoices. You cannot issue a credit note for an invoice you issued, in this use case contact the supplier to issue a credit note.

type Invoice {
// ...all generic invoice fields
  notes?: string;
  transactionType?: 'B2C' | 'B2B'
  invoiceRefs: string;
  lines: [
    { 
      // ..other line item fields
      vat: {
      // ...other line item vat fields
        code: string;
        exemptReason?:string;
        exemptReasonCode?: string;
      }
      customInfo?: {
        tur:{
          unitCode: 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
`invoiceRefs`	string	Yes	A string of existing invoices
`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. eArchive: Indicates the E-Archive (e-Arsiv) Invoice process.
`customInfo.tur.invoiceTypeCode`	string	Required	Code specifying the type of the Invoice. Return: For invoices issued by the buyer for the return of goods

Example CSV file

Credit note - tur.csv