Skip to content

TaxRmt

Provides remittance information about a payment made for tax-related purposes.

With the following properties:

PropertyTypeRequiredDescription
CdtrObjectOptionalParty on the credit side of the transaction to which the tax applies.
DbtrObjectOptionalIdentifies the party on the debit side of the transaction to which the tax applies.
UltmtDbtrObjectOptionalUltimate party that owes an amount of money to the (ultimate) creditor, in this case, to the taxing authority
AdmstnZoneStringOptionalTerritorial part of a country to which the tax payment is related. Maximum length: 35 characters
RefNbStringOptionalTax Reference information that is specific to a taxing agency. Maximum length: 140 characters
MtdStringOptionalMethod used to indicate the underlying business or how the tax is paid. Maximum length: 35 characters
TtlTaxblBaseAmtObjectOptionalTotal amount of money on which the tax is based.
TtlTaxAmtObjectOptionalTotal amount of money as result of the calculation of the tax.
DtStringOptionalDate by which tax is due. Format: date-time.
SeqNbintegerOptionalSequential number of the tax report.
RcrdObjectOptionalRecord of tax details.

Cdtr

Party on the credit side of the transaction to which the tax applies.

With the following properties:

PropertyTypeRequiredDescription
TaxIdstringoptionalTax identification number of the creditor. Maximum length: 35 characters
RegnIdstringoptionalUnique identification, as assigned by an organization, to unambiguously identify a party. Maximum length: 35 characters
TaxTpstringoptionalType of tax payer. Maximum length: 35 characters

Dbtr

Identifies the party on the debit side of the transaction to which the tax applies.

With the following properties:

PropertyTypeRequiredDescription
TaxIdstringoptionalTax identification number of the creditor. Maximum length: 35 characters
RegnIdstringoptionalUnique identification, as assigned by an organization, to unambiguously identify a party. Maximum length: 35 characters
TaxTpstringoptionalType of tax payer. Maximum length: 35 characters
AuthstnobjectoptionalDetails of the authorised tax paying party.

Dbtr.Authstn

Details of the authorised tax paying party.

With the following properties:

PropertyTypeRequiredDescription
TitlstringoptionalTitle or position of debtor or the debtor's authorised representative.. Maximum length: 35 characters
NmstringoptionalName of the debtor or the debtor's authorised representative. Maximum length: 140 characters

UltmtDbtr

Ultimate party that owes an amount of money to the (ultimate) creditor, in this case, to the taxing authority.

With the following properties:

PropertyTypeRequiredDescription
TaxIdstringoptionalTax identification number of the creditor. Maximum length: 35 characters
RegnIdstringoptionalUnique identification, as assigned by an organization, to unambiguously identify a party. Maximum length: 35 characters
TaxTpstringoptionalType of tax payer. Maximum length: 35 characters
AuthstnobjectoptionalDetails of the authorised tax paying party.

UltmtDbtr.Authstn

Details of the authorised tax paying party.

With the following properties:

PropertyTypeRequiredDescription
TitlstringoptionalTitle or position of debtor or the debtor's authorised representative. Maximum length: 35 characters
NmstringoptionalName of the debtor or the debtor's authorised representative. Maximum length: 140 characters

TtlTaxblBaseAmt

Total amount of money on which the tax is based.

With the following properties:

PropertyTypeRequiredDescription
amountstringoptionalAmount. Maximum length: 19 characters
currencystringoptionalCurrency for the amount, defined in #/definitions/currency

TtlTaxAmt

Total amount of money as result of the calculation of the tax.

With the following properties:

PropertyTypeRequiredDescription
amountstringoptionalAmount. Maximum length: 19 characters
currencystringoptionalCurrency for the amount, defined in #/definitions/currency

Rcrd

Record of tax details.

With the following properties:

PropertyTypeRequiredDescription
TpstringoptionalHigh level code to identify the type of tax details. Maximum length: 35 characters
CtgystringoptionalSpecifies the tax code as published by the tax authority. Maximum length: 35 characters
CtgyDtlsstringoptionalProvides further details of the category tax code. Maximum length: 35 characters
DbtrStsstringoptionalCode provided by local authority to identify the status of the party that has drawn up the settlement document. Maximum length: 35 characters
CertIdstringoptionalIdentification number of the tax report as assigned by the taxing authority. Maximum length: 35 characters
FrmsCdstringoptionalIdentifies, in a coded form, on which template the tax report is to be provided. Maximum length: 35 characters
PrdobjectoptionalSet of elements used to provide details on the period of time related to the tax payment.
TaxAmtobjectoptionalSet of elements used to provide information on the amount of the tax record.

Rcrd.Prd

Set of elements used to provide details on the period of time related to the tax payment.

With the following properties:

PropertyTypeRequiredDescription
YrstringoptionalYear related to the tax payment. Format: date-time
TpstringoptionalIdentification of the period related to the tax payment. Based on ISO TaxRecordPeriod1Code, the value of this property must be equal to one of the known values below.
FrToDtobjectoptionalRange of time between a start date and an end date for which the tax report is provided.
Prd.Tp known values
ValueDescription
MM01First Month
MM02Second Month
MM03Third Month
MM04Fourth Month
MM05Fifth Month
MM06Sixth Month
MM07Seventh Month
MM08Eighth Month
MM09Ninth Month
MM10Tenth Month
MM11Eleventh Month
MM12Twelfth Month
QTR1First Quarter
QTR2Second Quarter
QTR3Third Quarter
QTR4Fourth Quarter
HLF1First Half
HLF2Second Half

Rcrd.Prd.FrToDt

Range of time between a start date and an end date for which the tax report is provided.

With the following properties:

PropertyTypeRequiredDescription
FrDtstringoptionalStart date of the range. Format: date-time
ToDtstringoptionalEnd date of the range. Format: date-time

TaxAmt

Set of elements used to provide information on the amount of the tax record.

With the following properties:

PropertyTypeRequiredDescription
RatenumberoptionalRate used to calculate the tax. Percentage, minimum 0, maximum 100
TtlTaxblBaseAmtobjectoptionalAmount of money on which the tax is based.
TtlAmtobjectoptionalTotal amount that is the result of the calculation of the tax for the record.
DtlsobjectoptionalSet of elements used to provide details on the tax period and amount.
AddtlInfstringoptionalFurther details of the tax record. Max length 140 characters

TaxAmt.TtlTaxblBaseAmt

Amount of money on which the tax is based.

With the following properties:

PropertyTypeRequiredDescription
amountstringoptionalAmount. Maximum length: 19 characters
currencystringoptionalCurrency for the amount, defined in #/definitions/currency

TtlAmt

Total amount that is the result of the calculation of the tax for the record.

With the following properties:

PropertyTypeRequiredDescription
amountstringoptionalAmount. Maximum length: 19 characters
currencystringoptionalCurrency for the amount, defined in #/definitions/currency

Dtls

Set of elements used to provide details on the tax period and amount.

With the following properties:

PropertyTypeRequiredDescription
PrdobjectoptionalSet of elements used to provide details on the period of time related to the tax payment.
AmtsobjectoptionalUnderlying tax amount related to the specified period.

Dtls.Prd

Set of elements used to provide details on the period of time related to the tax payment.

With the following properties:

PropertyTypeRequiredDescription
YrstringoptionalYear related to the tax payment. Format: date-time
TpstringoptionalIdentification of the period related to the tax payment. Based on ISO TaxRecordPeriod1Code, the value of this property must be equal to one of the known values below.
FrToDtobjectoptionalRange of time between a start date and an end date for which the tax report is provided.
Dtls.Prd.Tp Known Values
ValueDescription
MM01First Month
MM02Second Month
MM03Third Month
MM04Fourth Month
MM05Fifth Month
MM06Sixth Month
MM07Seventh Month
MM08Eighth Month
MM09Ninth Month
MM10Tenth Month
MM11Eleventh Month
MM12Twelfth Month
QTR1First Quarter
QTR2Second Quarter
QTR3Third Quarter
QTR4Fourth Quarter
HLF1First Half
HLF2Second Half

Dtls.Prd.FrToDt

Range of time between a start date and an end date for which the tax report is provided.

With the following properties:

PropertyTypeRequiredDescription
FrDtstringoptionalStart date of the range. Format: date-time
ToDtstringoptionalEnd date of the range. Format: date-time

Dtls.Amt

Underlying tax amount related to the specified period.

With the following properties:

PropertyTypeRequiredDescription
amountstringoptionalAmount. Maximum length: 19 characters
currencystringoptionalCurrency for the amount, defined in #/definitions/currency

JSON schema extract

Click to expand
"TaxRmt": {
        "type": "object",
        "description": "Provides remittance information about a payment made for tax-related purposes.",
        "properties": {
            "Cdtr": {
                "type": "object",
                "description": "Party on the credit side of the transaction to which the tax applies.",
                "properties": {
                    "TaxId": {
                        "type": "string",
                        "description": "Tax identification number of the creditor.",
                        "maxLength": 35
                    },
                    "RegnId": {
                        "type": "string",
                        "description": "Unique identification, as assigned by an organization, to unambiguously identify a party.",
                        "maxLength": 35
                    },
                    "TaxTp": {
                        "type": "string",
                        "description": "Type of tax payer.",
                        "maxLength": 35
                    }
                }
            },
            "Dbtr": {
                "type": "object",
                "description": "Identifies the party on the debit side of the transaction to which the tax applies.",
                "properties": {
                    "TaxId": {
                        "type": "string",
                        "description": "Tax identification number of the debtor.",
                        "maxLength": 35
                    },
                    "RegnId": {
                        "type": "string",
                        "description": "Unique identification, as assigned by an organization, to unambiguously identify a party.",
                        "maxLength": 35
                    },
                    "TaxTp": {
                        "type": "string",
                        "description": "Type of tax payer.",
                        "maxLength": 35
                    },
                    "Authstn": {
                        "type": "object",
                        "description": "Details of the authorised tax paying party.",
                        "properties": {
                            "Titl": {
                                "type": "string",
                                "description": "Title or position of debtor or the debtor's authorised representative.",
                                "maxLength": 35
                            },
                            "Nm": {
                                "type": "string",
                                "description": "Name of the debtor or the debtor's authorised representative.",
                                "maxLength": 140
                            }
                        }
                    }
                }
            },
            "UltmtDbtr": {
                "type": "object",
                "description": "Ultimate party that owes an amount of money to the (ultimate) creditor, in this case, to the taxing authority.",
                "properties": {
                    "TaxId": {
                        "type": "string",
                        "description": "Tax identification number of the debtor.",
                        "maxLength": 35
                    },
                    "RegnId": {
                        "type": "string",
                        "description": "Unique identification, as assigned by an organization, to unambiguously identify a party.",
                        "maxLength": 35
                    },
                    "TaxTp": {
                        "type": "string",
                        "description": "Type of tax payer.",
                        "maxLength": 35
                    },
                    "Authstn": {
                        "type": "object",
                        "description": "Details of the authorised tax paying party.",
                        "properties": {
                            "Titl": {
                                "type": "string",
                                "description": "Title or position of debtor or the debtor's authorised representative.",
                                "maxLength": 35
                            },
                            "Nm": {
                                "type": "string",
                                "description": "Name of the debtor or the debtor's authorised representative.",
                                "maxLength": 140
                            }
                        }
                    }
                }
            },
            "AdmstnZone": {
                "type": "string",
                "description": "Territorial part of a country to which the tax payment is related.",
                "maxLength": 35
            },
            "RefNb": {
                "type": "string",
                "description": "Tax Reference information that is specific to a taxing agency.",
                "maxLength": 140
            },
            "Mtd": {
                "type": "string",
                "description": "Method used to indicate the underlying business or how the tax is paid.",
                "maxLength": 35
            },
            "TtlTaxblBaseAmt": {
                "type": "object",
                "description": "Total amount of money on which the tax is based.",
                "properties": {
                    "amount": {
                        "type": "string",
                        "maxLength": 19
                    },
                    "currency": {
                        "$ref": "#/definitions/currency"
                    }
                }
            },
            "TtlTaxAmt": {
                "type": "object",
                "description": "Total amount of money as result of the calculation of the tax.",
                "properties": {
                    "amount": {
                        "type": "string",
                        "maxLength": 19
                    },
                    "currency": {
                        "$ref": "#/definitions/currency"
                    }
                }
            },
            "Dt": {
                "type": "string",
                "description": "Date by which tax is due.",
                "format": "date-time"
            },
            "SeqNb": {
                "type": "integer",
                "description": "Sequential number of the tax report."
            },
            "Rcrd": {
                "type": "object",
                "description": "Record of tax details.",
                "properties": {
                    "Tp": {
                        "type": "string",
                        "description": "High level code to identify the type of tax details.",
                        "maxLength": 35
                    },
                    "Ctgy": {
                        "type": "string",
                        "description": "Specifies the tax code as published by the tax authority.",
                        "maxLength": 35
                    },
                    "CtgyDtls": {
                        "type": "string",
                        "description": "Provides further details of the category tax code.",
                        "maxLength": 35
                    },
                    "DbtrSts": {
                        "type": "string",
                        "description": "Code provided by local authority to identify the status of the party that has drawn up the settlement document.",
                        "maxLength": 35
                    },
                    "CertId": {
                        "type": "string",
                        "description": "Identification number of the tax report as assigned by the taxing authority.",
                        "maxLength": 35
                    },
                    "FrmsCd": {
                        "type": "string",
                        "description": "Identifies, in a coded form, on which template the tax report is to be provided.",
                        "maxLength": 35
                    },
                    "Prd": {
                        "type": "object",
                        "description": "Set of elements used to provide details on the period of time related to the tax payment.",
                        "properties": {
                            "Yr": {
                                "type": "string",
                                "description": "Year related to the tax payment.",
                                "format": "date-time"
                            },
                            "Tp": {
                                "type": "string",
                                "description": "Identification of the period related to the tax payment. Based on ISO TaxRecordPeriod1Code",
                                "enum": [
                                    "MM01",
                                    "MM02",
                                    "MM03",
                                    "MM04",
                                    "MM05",
                                    "MM06",
                                    "MM07",
                                    "MM08",
                                    "MM09",
                                    "MM10",
                                    "MM11",
                                    "MM12",
                                    "QTR1",
                                    "QTR2",
                                    "QTR3",
                                    "QTR4",
                                    "HLF1",
                                    "HLF2"
                                ]
                            },
                            "FrToDt": {
                                "type": "object",
                                "description": "Range of time between a start date and an end date for which the tax report is provided.",
                                "properties": {
                                    "FrDt": {
                                        "type": "string",
                                        "description": "Start date of the range.",
                                        "format": "date-time"
                                    },
                                    "ToDt": {
                                        "type": "string",
                                        "description": "End date of the range.",
                                        "format": "date-time"
                                    }
                                }
                            }
                        }
                    },
                    "TaxAmt": {
                        "type": "object",
                        "description": "Set of elements used to provide information on the amount of the tax record.",
                        "properties": {
                            "Rate": {
                                "type": "number",
                                "description": "Rate used to calculate the tax. ",
                                "minimum": 0,
                                "maximum": 100,
                                "multiplpeOf": 1e-10
                            },
                            "TtlTaxblBaseAmt": {
                                "type": "object",
                                "description": "Amount of money on which the tax is based.",
                                "properties": {
                                    "amount": {
                                        "type": "string",
                                        "maxLength": 19
                                    },
                                    "currency": {
                                        "$ref": "#/definitions/currency"
                                    }
                                }
                            },
                            "TtlAmt": {
                                "type": "object",
                                "description": "Total amount that is the result of the calculation of the tax for the record.",
                                "properties": {
                                    "amount": {
                                        "type": "string",
                                        "maxLength": 19
                                    },
                                    "currency": {
                                        "$ref": "#/definitions/currency"
                                    }
                                }
                            },
                            "Dtls": {
                                "type": "object",
                                "description": "Set of elements used to provide details on the tax period and amount.",
                                "properties": {
                                    "Prd": {
                                        "type": "object",
                                        "description": "Set of elements used to provide details on the period of time related to the tax payment.",
                                        "properties": {
                                            "Yr": {
                                                "type": "string",
                                                "description": "Year related to the tax payment.",
                                                "format": "date-time"
                                            },
                                            "Tp": {
                                                "type": "string",
                                                "description": "Identification of the period related to the tax payment. Based on ISO TaxRecordPeriod1Code",
                                                "enum": [
                                                    "MM01",
                                                    "MM02",
                                                    "MM03",
                                                    "MM04",
                                                    "MM05",
                                                    "MM06",
                                                    "MM07",
                                                    "MM08",
                                                    "MM09",
                                                    "MM10",
                                                    "MM11",
                                                    "MM12",
                                                    "QTR1",
                                                    "QTR2",
                                                    "QTR3",
                                                    "QTR4",
                                                    "HLF1",
                                                    "HLF2"
                                                ]
                                            },
                                            "FrToDt": {
                                                "type": "object",
                                                "description": "Range of time between a start date and an end date for which the tax report is provided.",
                                                "properties": {
                                                    "FrDt": {
                                                        "type": "string",
                                                        "description": "Start date of the range.",
                                                        "format": "date-time"
                                                    },
                                                    "ToDt": {
                                                        "type": "string",
                                                        "description": "End date of the range.",
                                                        "format": "date-time"
                                                    }
                                                }
                                            }
                                        }
                                    },
                                    "Amt": {
                                        "type": "object",
                                        "description": "Underlying tax amount related to the specified period.",
                                        "properties": {
                                            "amount": {
                                                "type": "string",
                                                "maxLength": 19
                                            },
                                            "currency": {
                                                "$ref": "#/definitions/currency"
                                            }
                                        }
                                    }
                                }
                            },
                            "AddtlInf": {
                                "type": "string",
                                "description": "Further details of the tax record.",
                                "maxLength": 140
                            }
                        }
                    }
                }
            }
        }
    }