> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.staple.ai/e-invoice/reference/payloads/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.staple.ai/_mcp/server.

# Request Payloads

Select a country to see the minimum required payload Staple needs to start compliance processing, plus the **Staple model field names** to create. Fields shown are required and country-specific — invoice-level optional fields (notes, attachments, payment details, etc.) are omitted for clarity. See [Schema Objects](/e-invoice/reference/schema-objects) for the full reference.

#### 🇸🇬 Singapore

**Format:** Standard GST · no mandatory e-invoicing format

```json
{
  "Country": "SG",
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "SGD",
  "Supplier": {
    "Name": "Acme Pte. Ltd.",
    "TaxID": { "Country": "SG", "Code": "200312345A" }
  },
  "Customer": {
    "Name": "Buyer Pte. Ltd.",
    "TaxID": { "Country": "SG", "Code": "201998765B" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Consulting service", "Price": "1000.00" },
    "Taxes": [{ "Cat": "GST", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 15 fields

`Country` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇨🇳 China

**Format:** VAT · Golden Tax System (Fapiao)

```json
{
  "Country": "CN",
  "ComplianceStandards": ["cn-golden-tax-v1"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "CNY",
  "Supplier": {
    "Name": "上海科技有限公司",
    "TaxID": { "Country": "CN", "Code": "91310000MA1FL4XH29" }
  },
  "Customer": {
    "Name": "北京贸易有限公司",
    "TaxID": { "Country": "CN", "Code": "91110000MA009BXF2X" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "技术服务费", "Price": "10000.00" },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 16 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇲🇾 Malaysia

**Format:** MyInvois v1.1 · LHDN · TIN + BRN + SST + MSIC required

```json
{
  "Country": "MY",
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "IssueTime": "10:30:00",
  "Currency": "MYR",
  "Supplier": {
    "Name": "Acme Sdn. Bhd.",
    "TaxID": { "Country": "MY", "Code": "C2584563200" },
    "Identities": [
      { "Key": "BRN", "Code": "202001234567" },
      { "Key": "SST", "Code": "A01-2345-67891012" },
      { "Key": "MSIC", "Code": "46510" }
    ],
    "Addresses": [{
      "Street": "Jalan Ampang",
      "Locality": "Kuala Lumpur",
      "Code": "50450",
      "Country": "MY"
    }],
    "Meta": { "msic-description": "Computer and peripheral equipment" }
  },
  "Customer": {
    "Name": "Buyer Sdn. Bhd.",
    "TaxID": { "Country": "MY", "Code": "C9876543210" },
    "Identities": [
      { "Key": "BRN", "Code": "201998765432" }
    ],
    "Addresses": [{
      "Street": "Jalan Tun Razak",
      "Locality": "Kuala Lumpur",
      "Code": "50400",
      "Country": "MY"
    }]
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": {
      "Name": "Consulting service",
      "Price": "1000.00",
      "Identities": [{ "Key": "CLASS", "Code": "022" }]
    },
    "Taxes": [{ "Cat": "SST", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 26 fields

`Country` · `DocNumber` · `IssueDate` · `IssueTime` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `SupplierIdentitiesKey` · `SupplierIdentitiesCode` · `SupplierAddressesStreet` · `SupplierAddressesLocality` · `SupplierAddressesCode` · `SupplierAddressesCountry` · `SupplierMetaMsicDescription` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `CustomerIdentitiesKey` · `CustomerIdentitiesCode` · `CustomerAddressesStreet` · `CustomerAddressesLocality` · `CustomerAddressesCode` · `CustomerAddressesCountry` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesItemIdentitiesKey` · `LinesItemIdentitiesCode` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇵🇱 Poland

**Format:** FA\_VAT · KSeF

```json
{
  "Country": "PL",
  "ComplianceStandards": ["pl-ksef-v1"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "PLN",
  "Supplier": {
    "Name": "Acme Sp. z o.o.",
    "TaxID": { "Country": "PL", "Code": "PL1234567890" }
  },
  "Customer": {
    "Name": "Buyer Sp. z o.o.",
    "TaxID": { "Country": "PL", "Code": "PL0987654321" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Usługi konsultingowe", "Price": "5000.00" },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 16 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇫🇷 France

**Format:** Factur-X · PPF

```json
{
  "Country": "FR",
  "ComplianceStandards": ["eu-en16931-v2017", "fr-facturx-v1"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "EUR",
  "Supplier": {
    "Name": "Acme SAS",
    "TaxID": { "Country": "FR", "Code": "FR12345678901" }
  },
  "Customer": {
    "Name": "Buyer SAS",
    "TaxID": { "Country": "FR", "Code": "FR98765432109" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Services de conseil", "Price": "1000.00" },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 16 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇧🇪 Belgium

**Format:** Standard EU VAT

```json
{
  "Country": "BE",
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "EUR",
  "Supplier": {
    "Name": "Acme NV",
    "TaxID": { "Country": "BE", "Code": "BE0123456789" }
  },
  "Customer": {
    "Name": "Buyer NV",
    "TaxID": { "Country": "BE", "Code": "BE0987654321" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Services", "Price": "500.00" },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 15 fields

`Country` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇮🇹 Italy

**Format:** FatturaPA v1.2 · SDI · registration capital required

```json
{
  "Country": "IT",
  "ComplianceStandards": ["it-sdi-v1"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "EUR",
  "Supplier": {
    "Name": "Acme S.r.l.",
    "TaxID": { "Country": "IT", "Code": "12345678901" },
    "Addresses": [{
      "Street": "Via Roma",
      "Num": "1",
      "Locality": "Roma",
      "Code": "00100",
      "Country": "IT"
    }],
    "Registration": {
      "Capital": "100000.00",
      "Currency": "EUR",
      "Office": "Roma"
    }
  },
  "Customer": {
    "Name": "Buyer S.r.l.",
    "TaxID": { "Country": "IT", "Code": "98765432109" },
    "Addresses": [{
      "Street": "Via Milano",
      "Num": "10",
      "Locality": "Milano",
      "Code": "20100",
      "Country": "IT"
    }]
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": {
      "Name": "Servizi di consulenza",
      "Price": "1000.00",
      "Ext": { "it-sdi-nature": "N1" }
    },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard", "Ext": { "it-sdi-nature": "N1" } }]
  }]
}
```

**Required Staple model fields** — 33 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `SupplierAddressesStreet` · `SupplierAddressesNum` · `SupplierAddressesLocality` · `SupplierAddressesCode` · `SupplierAddressesCountry` · `SupplierRegistrationCapital` · `SupplierRegistrationCurrency` · `SupplierRegistrationOffice` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `CustomerAddressesStreet` · `CustomerAddressesNum` · `CustomerAddressesLocality` · `CustomerAddressesCode` · `CustomerAddressesCountry` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesItemExtItSdiNature` · `LinesTaxesCat` · `LinesTaxesRate` · `LinesTaxesExtItSdiNature`

#### 🇩🇪 Germany

**Format:** XRechnung v3 · Peppol · buyer reference required

```json
{
  "Country": "DE",
  "ComplianceStandards": ["eu-en16931-v2017", "de-xrechnung-v3"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "EUR",
  "Supplier": {
    "Name": "Mustermann GmbH",
    "TaxID": { "Country": "DE", "Code": "111111125" },
    "Addresses": [{
      "Street": "Dietmar-Hopp-Allee",
      "Num": "16",
      "Locality": "Walldorf",
      "Code": "69190",
      "Country": "DE"
    }]
  },
  "Customer": {
    "Name": "Buyer GmbH",
    "TaxID": { "Country": "DE", "Code": "222222229" },
    "Addresses": [{
      "Street": "Hauptstraße",
      "Num": "1",
      "Locality": "Berlin",
      "Code": "10115",
      "Country": "DE"
    }]
  },
  "Ordering": { "Code": "BUYER-REF-001" },
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Consulting service", "Price": "1000.00" },
    "Taxes": [{ "Cat": "VAT", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 27 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `SupplierAddressesStreet` · `SupplierAddressesNum` · `SupplierAddressesLocality` · `SupplierAddressesCode` · `SupplierAddressesCountry` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `CustomerAddressesStreet` · `CustomerAddressesNum` · `CustomerAddressesLocality` · `CustomerAddressesCode` · `CustomerAddressesCountry` · `OrderingCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate`

#### 🇪🇸 Spain

**Format:** VeriFactu + TicketBAI · general note required

```json
{
  "Country": "ES",
  "ComplianceStandards": ["es-verifactu-v1"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "EUR",
  "Supplier": {
    "Name": "Acme S.L.",
    "TaxID": { "Country": "ES", "Code": "B12345678" }
  },
  "Customer": {
    "Name": "Buyer S.L.",
    "TaxID": { "Country": "ES", "Code": "B98765432" }
  },
  "Notes": [{ "Key": "general", "Text": "Consulting services rendered in May 2026" }],
  "Lines": [{
    "Quantity": "1.00",
    "Item": { "Name": "Servicios de consultoría", "Price": "1000.00" },
    "Taxes": [{
      "Cat": "VAT",
      "Rate": "standard",
      "Ext": { "es-verifactu-regime": "01" }
    }]
  }]
}
```

**Required Staple model fields** — 19 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `NotesKey` · `NotesText` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesTaxesCat` · `LinesTaxesRate` · `LinesTaxesExtEsVerifactuRegime`

#### 🇧🇷 Brazil

**Format:** NF-e / NFS-e · SEFAZ · fiscal operation + service code `Ext` required

```json
{
  "Country": "BR",
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "BRL",
  "Supplier": {
    "Name": "Acme Ltda.",
    "TaxID": { "Country": "BR", "Code": "12.345.678/0001-90" }
  },
  "Customer": {
    "Name": "Buyer Ltda.",
    "TaxID": { "Country": "BR", "Code": "98.765.432/0001-10" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": {
      "Name": "Serviços de consultoria",
      "Price": "5000.00",
      "Ext": { "br-nfse-service-code": "0101" }
    },
    "Taxes": [{
      "Cat": "VAT",
      "Rate": "standard",
      "Ext": { "br-nfe-fiscal-operation": "5101" }
    }]
  }]
}
```

**Required Staple model fields** — 17 fields

`Country` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesItemExtBrNfseServiceCode` · `LinesTaxesCat` · `LinesTaxesRate` · `LinesTaxesExtBrNfeFiscalOperation`

#### 🇲🇽 Mexico

**Format:** CFDI v4 · SAT · product code + tax type `Ext` required

```json
{
  "Country": "MX",
  "ComplianceStandards": ["mx-cfdi-v4"],
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "IssueTime": "10:30:00",
  "Currency": "MXN",
  "Supplier": {
    "Name": "Empresa Mexicana S.A. de C.V.",
    "TaxID": { "Country": "MX", "Code": "EMP010101ABC" },
    "Addresses": [{
      "Street": "Av. Reforma",
      "Locality": "Ciudad de México",
      "State": "CDMX",
      "Code": "06600",
      "Country": "MX"
    }]
  },
  "Customer": {
    "Name": "Cliente S.A. de C.V.",
    "TaxID": { "Country": "MX", "Code": "CLI990101XYZ" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": {
      "Name": "Servicios de consultoría",
      "Price": "10000.00",
      "Ext": { "mx-cfdi-prod-serv": "84111506" }
    },
    "Taxes": [{
      "Cat": "VAT",
      "Rate": "standard",
      "Ext": { "mx-cfdi-tax-type": "002" }
    }]
  }]
}
```

**Required Staple model fields** — 24 fields

`Country` · `ComplianceStandards` · `DocNumber` · `IssueDate` · `IssueTime` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `SupplierAddressesStreet` · `SupplierAddressesLocality` · `SupplierAddressesState` · `SupplierAddressesCode` · `SupplierAddressesCountry` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesItemExtMxCfdiProdServ` · `LinesTaxesCat` · `LinesTaxesRate` · `LinesTaxesExtMxCfdiTaxType`

#### 🇮🇳 India

**Format:** GST · IRN · HSN code required

```json
{
  "Country": "IN",
  "DocNumber": "INV-0001",
  "IssueDate": "2026-05-09",
  "Currency": "INR",
  "Supplier": {
    "Name": "Acme Pvt. Ltd.",
    "TaxID": { "Country": "IN", "Code": "27AAACR5055K1ZV" }
  },
  "Customer": {
    "Name": "Buyer Pvt. Ltd.",
    "TaxID": { "Country": "IN", "Code": "29AABCB1234M1Z5" }
  },
  "Lines": [{
    "Quantity": "1.00",
    "Item": {
      "Name": "Consulting service",
      "Price": "50000.00",
      "Identities": [{ "Key": "HSN", "Code": "998311" }]
    },
    "Taxes": [{ "Cat": "IGST", "Rate": "standard" }]
  }]
}
```

**Required Staple model fields** — 17 fields

`Country` · `DocNumber` · `IssueDate` · `Currency` · `SupplierName` · `SupplierTaxIDCountry` · `SupplierTaxIDCode` · `CustomerName` · `CustomerTaxIDCountry` · `CustomerTaxIDCode` · `LinesQuantity` · `LinesItemName` · `LinesItemPrice` · `LinesItemIdentitiesKey` · `LinesItemIdentitiesCode` · `LinesTaxesCat` · `LinesTaxesRate`

> Minimum required payload per country