FlexyAPI documentation

Examples

1.1 Sales Invoice

Examples for document 1.1 – Sales Invoice.

Examples for document 1.1 – Sales Invoice. How to send the requests: Examples.

Basic example

Test Company ΕΠΕ sells one Premium Widget to Customer Company ΑΕ with net 100.00 € and VAT 24% (124.00 € total).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Premium Widget",
        "description": "High-quality widget product",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "100.00",
      "tax_exclusive_amount": "100.00",
      "tax_amount": "24.00",
      "tax_inclusive_amount": "124.00",
      "payable_amount": "124.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "100.00",
        "tax_amount": "24.00"
      }
    ],
    "public_notes": "Test invoice with totals validation"
  }
}

With a correlated document

Replace <MARK> in related_documents with the MARK of a 1.1 invoice you have already issued, e.g. the basic example above.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A2",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Premium Widget",
        "description": "High-quality widget product",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "100.00",
      "tax_exclusive_amount": "100.00",
      "tax_amount": "24.00",
      "tax_inclusive_amount": "124.00",
      "payable_amount": "124.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "100.00",
        "tax_amount": "24.00"
      }
    ],
    "public_notes": "Test invoice with totals validation",
    "related_documents": [
      "<MARK>"
    ]
  }
}

With a correlated entity

Adds the entity Φορολογικός Εκπρόσωπος ΑΕ to other_correlated_entities (type: 1, VAT number 094259216).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A3",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": [
        {
          "type": 1,
          "entity_data": {
            "vat_number": "094259216",
            "country": "GR",
            "branch": 0,
            "name": "Φορολογικός Εκπρόσωπος ΑΕ"
          }
        }
      ],
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Premium Widget",
        "description": "High-quality widget product",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "100.00",
      "tax_exclusive_amount": "100.00",
      "tax_amount": "24.00",
      "tax_inclusive_amount": "124.00",
      "payable_amount": "124.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "100.00",
        "tax_amount": "24.00"
      }
    ],
    "public_notes": "Test invoice with totals validation"
  }
}

With dispatch data

Adds dispatch data and is_delivery_note: true, with the line changed to Εμπόρευμα Α (2 units × 50.00 €).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A4",
    "date": "YYYY-MM-DD",
    "is_delivery_note": true,
    "dispatch": {
      "dispatch_date": "YYYY-MM-DD",
      "dispatch_time": "10:00:00",
      "move_purpose": 1,
      "vehicle_number": "ΑΒΓ-1234",
      "loading_address": {
        "address_line": "Πανεπιστημίου 123",
        "street": "Πανεπιστημίου",
        "number": "123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR"
      },
      "shipping_address": {
        "address_line": "Σταδίου 456",
        "street": "Σταδίου",
        "number": "456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR"
      }
    },
    "provider_details": {
      "document_type": "1.1",
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "items": [
      {
        "title": "Εμπόρευμα Α",
        "description": "Εμπόρευμα Α προς αποστολή",
        "item_code": "EMP-A-001",
        "quantity": "2.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "50.00",
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1"
        }
      }
    ],
    "totals": {
      "line_extension_amount": "100.00",
      "tax_exclusive_amount": "100.00",
      "tax_amount": "24.00",
      "tax_inclusive_amount": "124.00",
      "payable_amount": "124.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "100.00",
        "tax_amount": "24.00"
      }
    ]
  }
}

With a long description

The line's description is set to a very long text.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A5",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Premium Widget",
        "description": "Λεπτομερής περιγραφή προϊόντος με τεχνικά χαρακτηριστικά, διαστάσεις, υλικά κατασκευής, οδηγίες χρήσης, εγγύηση και συμμόρφωση με τα πρότυπα ΕΕ. Λεπτομερής περιγραφή προϊόντος με τεχνικά χαρακτηριστικά, διαστάσεις, υλικά κατασκευής, οδηγίες χρήσης, εγγύηση και συμμόρφωση με τα πρότυπα ΕΕ. Λεπτομερής",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "100.00",
      "tax_exclusive_amount": "100.00",
      "tax_amount": "24.00",
      "tax_inclusive_amount": "124.00",
      "payable_amount": "124.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "100.00",
        "tax_amount": "24.00"
      }
    ],
    "public_notes": "Test invoice with totals validation"
  }
}

Three lines for the same product

Three lines for the same product (Flexy Basic), one per customer with per-line descriptions.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A6",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Flexy Basic",
        "description": "Τελικός πελάτης Κώστας",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "100.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      },
      {
        "title": "Flexy Basic",
        "description": "Τελικός πελάτης Νίκος",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "80.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "80.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      },
      {
        "title": "Flexy Basic",
        "description": "Τελικός πελάτης Μαρία",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "50.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "50.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "230.00",
      "tax_exclusive_amount": "230.00",
      "tax_amount": "55.20",
      "tax_inclusive_amount": "285.20",
      "payable_amount": "285.20"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "230.00",
        "tax_amount": "55.20"
      }
    ],
    "public_notes": "Same product on three lines at different prices"
  }
}

Self-billing

With self_pricing: true and Supplier ABC ΕΠΕ as the counterpart, for 1000.00 € of services with 24% VAT (1240.00 € total).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "SB",
    "date": "YYYY-MM-DD",
    "self_pricing": true,
    "provider_details": {
      "document_type": "1.1",
      "payment_method_type": "5"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Supplier ABC ΕΠΕ",
      "legal_number": "159107845",
      "legal_activity": "Services",
      "address": {
        "address_line": "Stadiou 10",
        "city": "Athens",
        "state": "Attica",
        "zip": "10562",
        "country": "GR",
        "branch_code": 0
      }
    },
    "items": [
      {
        "title": "Professional Services",
        "description": "Consulting services received",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "1000.00",
        "unit_total": "1000.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category2_3",
          "classification_type": "E3_585_016",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "totals": {
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_amount": "240.00",
      "tax_inclusive_amount": "1240.00",
      "payable_amount": "1240.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "1000.00",
        "tax_amount": "240.00"
      }
    ],
    "public_notes": "Self-billing invoice for professional services"
  }
}

With stamp duty

Adds stamp duty 3.6% on top of VAT 24% (VAT 240.00 € + stamp 36.00 €, total 1276.00 €).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "A7",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Premium Widget",
        "description": "High-quality widget with stamp duty",
        "quantity": "10.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "100.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "1000.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          },
          {
            "title": "Χαρτόσημο 3.6%",
            "tax_type": "stamp_duty",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "3.6",
            "provider_code": null,
            "on_vat": false,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "3"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_amount": "276.00",
      "tax_inclusive_amount": "1276.00",
      "payable_amount": "1276.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "1000.00",
        "tax_amount": "240.00",
        "tax_type": "vat"
      },
      {
        "tax_category_id": "SD",
        "tax_category_name": "Stamp Duty 3.6%",
        "tax_rate_percent": "3.60",
        "taxable_amount": "1000.00",
        "tax_amount": "36.00",
        "tax_type": "stamp_duty"
      }
    ],
    "public_notes": "Test invoice with VAT and Stamp Duty"
  }
}

VAT exemption (article 39a)

One line with 0% VAT (vat_classification_category: 7) and the tax title «ΦΠΑ 0% (Απαλλαγή Άρθρο 39α)», net 1000.00 €.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "EX",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "payment_method_type": "5"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer XYZ ΕΠΕ",
      "legal_number": "159107845",
      "legal_activity": "Trading",
      "address": {
        "address_line": "Stadiou 20",
        "city": "Athens",
        "state": "Attica",
        "zip": "10562",
        "country": "GR",
        "branch_code": 0
      }
    },
    "items": [
      {
        "title": "Goods for Intra-Community Transaction",
        "description": "Products subject to Article 39a VAT exemption",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "1000.00",
        "unit_total": "1000.00",
        "taxes": [
          {
            "title": "ΦΠΑ 0% (Απαλλαγή Άρθρο 39α)",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "0.00",
            "provider_code": "7",
            "on_vat": true,
            "provider_details": {
              "provider_code": "7"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "7",
          "vat_exemption_category": "1"
        }
      }
    ],
    "totals": {
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_amount": "0.00",
      "tax_inclusive_amount": "1000.00",
      "payable_amount": "1000.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "E",
        "tax_category_name": "ΦΠΑ 0% Απαλλαγή Άρθρο 39α",
        "tax_rate_percent": "0.00",
        "taxable_amount": "1000.00",
        "tax_amount": "0.00"
      }
    ],
    "public_notes": "Invoice with VAT exemption under Article 39a for intra-community transactions"
  }
}

Fuel invoice

Fuel invoice flag (fuel_invoice: true) and fuel_code: 10 for 50 LT unleaded 95 with VAT 24% (111.60 € total).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "F",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": true,
      "special_invoice_category": null,
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "3"
    },
    "issuer": {
      "legal_name": "Test Fuel Station ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Πώληση Καυσίμων",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Αμόλυβδη 95",
        "description": "Αμόλυβδη βενζίνη 95 οκτανίων",
        "quantity": "50.00",
        "unit_measure": "LT",
        "unit_value": "1.80",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "90.00",
        "fuel_code": 10,
        "quantity15": "49.50",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "90.00",
      "tax_exclusive_amount": "90.00",
      "tax_amount": "21.60",
      "tax_inclusive_amount": "111.60",
      "payable_amount": "111.60"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "90.00",
        "tax_amount": "21.60"
      }
    ]
  }
}

With special invoice category

Special category 1 (special_invoice_category: 1) for a 1000.00 € subsidy with VAT 24%.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "SUB",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "fuel_invoice": null,
      "special_invoice_category": "1",
      "invoice_variation_type": null,
      "other_correlated_entities": null,
      "other_delivery_note_header": null,
      "reverse_delivery_note": null,
      "payment_method_type": "5"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer Company ΑΕ",
      "legal_number": "159107845",
      "legal_activity": "Λιανικό Εμπόριο",
      "address": {
        "address_line": "Σταδίου 456",
        "city": "Θεσσαλονίκη",
        "state": "Θεσσαλονίκη",
        "zip": "54625",
        "country": "GR",
        "branch_code": 0
      }
    },
    "dispatch": null,
    "exchange_rates": null,
    "items": [
      {
        "title": "Επιδότηση - Επιχορήγηση",
        "description": "Government subsidy income",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "1000.00",
        "unit_discount": null,
        "unit_discount_percentage": null,
        "unit_discount_mode": null,
        "unit_total": "1000.00",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "quantity_dependent": false,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1",
          "vat_exemption_category": "1"
        }
      }
    ],
    "taxes": null,
    "totals": {
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_amount": "240.00",
      "tax_inclusive_amount": "1240.00",
      "payable_amount": "1240.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ Κανονικός 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "1000.00",
        "tax_amount": "240.00"
      }
    ]
  }
}

Customer abroad without a VAT number

A counterpart in Germany with legal_number DE000000000 and two lines with 24% VAT (12.93 € total).

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "3",
    "date": "YYYY-MM-DD",
    "currency": "EUR",
    "provider_details": {
      "document_type": "1.1",
      "payment_method_type": "5"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Scarlet J.",
      "legal_number": "DE000000000",
      "email": "[email protected]",
      "phone": "6936936933",
      "address": {
        "address_line": "Barbara Str. 100",
        "street": "Barbara Str.",
        "number": "100",
        "city": "London",
        "state": "London",
        "zip": "125869",
        "country": "DE",
        "branch_code": 0
      }
    },
    "items": [
      {
        "item_code": "000231",
        "title": "CABLE USB M/F 3M",
        "description": "CABLE USB M/F 3M",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "6.46",
        "unit_total": "6.46",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1"
        }
      },
      {
        "item_code": "000232",
        "title": "DRIVE SLOT SATA HDD CADDY",
        "description": "DRIVE SLOT SATA HDD CADDY",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "3.97",
        "unit_total": "3.97",
        "taxes": [
          {
            "title": "ΦΠΑ 24%",
            "tax_type": "1",
            "value_type": "percentage",
            "value": "24.00",
            "provider_code": "1",
            "on_vat": true,
            "provider_details": {
              "provider_code": "1"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "1"
        }
      }
    ],
    "totals": {
      "line_extension_amount": "10.43",
      "tax_exclusive_amount": "10.43",
      "tax_amount": "2.50",
      "tax_inclusive_amount": "12.93",
      "payable_amount": "12.93"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "S",
        "tax_category_name": "ΦΠΑ 24%",
        "tax_rate_percent": "24.00",
        "taxable_amount": "10.43",
        "tax_amount": "2.50"
      }
    ]
  }
}

Reverse charge

One line with 0% VAT (vat_classification_category: 7, provider_code: 8) and the tax title «ΦΠΑ 0% (Αντίστροφη Επιβάρυνση)», net 1000.00 €.

{
  "document": {
    "provider": "flexy",
    "document_type": "invoice",
    "aa": "YYYYMMDDHHMMSS",
    "series": "RC",
    "date": "YYYY-MM-DD",
    "provider_details": {
      "document_type": "1.1",
      "payment_method_type": "5"
    },
    "issuer": {
      "legal_name": "Test Company ΕΠΕ",
      "legal_number": "<VAT NUMBER>",
      "legal_activity": "Χονδρικό Εμπόριο",
      "address": {
        "address_line": "Πανεπιστημίου 123",
        "city": "Αθήνα",
        "state": "Αττική",
        "zip": "10678",
        "country": "GR",
        "branch_code": 0
      }
    },
    "counterpart": {
      "legal_name": "Customer XYZ ΕΠΕ",
      "legal_number": "159107845",
      "legal_activity": "Professional Services",
      "address": {
        "address_line": "Stadiou 20",
        "city": "Athens",
        "state": "Attica",
        "zip": "10562",
        "country": "GR",
        "branch_code": 0
      }
    },
    "items": [
      {
        "title": "Professional Consulting Services",
        "description": "Services subject to reverse charge mechanism",
        "quantity": "1.00",
        "unit_measure": "ΤΕΜ",
        "unit_value": "1000.00",
        "unit_total": "1000.00",
        "taxes": [
          {
            "title": "ΦΠΑ 0% (Αντίστροφη Επιβάρυνση)",
            "tax_type": "1",
            "value_type": "percentage",
            "tax_sign": "+",
            "value": "0.00",
            "provider_code": "8",
            "on_vat": true,
            "provider_details": {
              "provider_code": "8"
            }
          }
        ],
        "provider_details": {
          "classification_category": "category1_1",
          "classification_type": "E3_561_001",
          "vat_classification_category": "7",
          "vat_exemption_category": "1"
        }
      }
    ],
    "totals": {
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_amount": "0.00",
      "tax_inclusive_amount": "1000.00",
      "payable_amount": "1000.00"
    },
    "tax_breakdown": [
      {
        "tax_category_id": "AE",
        "tax_category_name": "ΦΠΑ 0% Αντίστροφη Επιβάρυνση",
        "tax_rate_percent": "0.00",
        "taxable_amount": "1000.00",
        "tax_amount": "0.00"
      }
    ],
    "public_notes": "Invoice with reverse charge - VAT to be paid by recipient"
  }
}