Description
Check term against allowedTerms and place for nonwhitespace text.
Trade-finance arithmetic combines supplied fees, exchange factors, timing windows, and reporting bases. A local consistency result does not establish document compliance, contract rights, or bank acceptance.
Check term against allowedTerms and place for nonwhitespace text.
When to use this tool
Use Freight Term Place Qualifier Token when you need one transparent cross-border cost or timing component.
How to use the tool and how it works
- Enter term, place, suppliedEdition, allowedTerms. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read recognized, hasPlace, key. Inspect recognized, hasPlace before interpreting the associated values.
Check term against allowedTerms and place for nonwhitespace text. Serialize suppliedEdition, term, and the original place into key.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| term | Single mathematical contribution; aggregation and normalization are separate. | Required. Text; maximum UTF-16 length 8192. |
| place | Place | Required. Text; maximum UTF-16 length 8192. |
| suppliedEdition | Supplied Edition | Required. Text; maximum UTF-16 length 8192. |
| allowedTerms | Allowed Terms | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| recognized | Whether the exact token occurs in the supplied vocabulary. | Required. Boolean. |
| hasPlace | Has Place | Required. Boolean. |
| key | JSON-array serialization of the stated identifying fields, preserving exact strings. | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"term": "FCA",
"place": "Port A",
"suppliedEdition": "2020",
"allowedTerms": [
"FCA",
"DAP"
]
},
"output": {
"recognized": true,
"hasPlace": true,
"key": "[\"2020\",\"FCA\",\"Port A\"]"
}
}Limitations and assumptions
- This does not validate an Incoterms edition, a location, or allocation of costs and risk.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Review the complete transaction, contract, bank terms, and applicable accounting policies before acting on a partial calculation.
References
Similar or alternative tools
- Incoterm Cost Line Share
Require aligned nonnegative costs and lineTerms, sum costs whose label exactly matches requestedTerm, and divide by positive totalCost.
- Identifier Namespace Version Token
Split at the first namespace separator and the final version separator in the tail, requiring nonempty resulting components.