Zum Inhalt
HALOWERK

Finopswerk

foreign receivable fx ledger

One originalforeign-currency monetarytrade receivable/initialspotrate plus ordered closingremeasurements andpartialcollections determine remainingforeignunits,functionalcarryingvalue,currentcarryingrate,collectioncash,realized/remeasurementexchange differences,cumulativetotals andconservation. Rate_milli isfunctionalminorunitsperforeignminorunit times1000. Closingop0requiresforeign_received0.

POST https://finops.halowerk.com/v1/foreign-receivable-fx-ledger

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
eventsarrayJa
reportobjectJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "op": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1
          },
          "foreign_received": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "rate_domain": {
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000
            },
            "minItems": 1,
            "maxItems": 2
          }
        },
        "required": [
          "op",
          "foreign_received",
          "rate_domain"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 6
    },
    "report": {
      "type": "object",
      "required": [
        "remaining_foreign",
        "reference_rate",
        "carrying_value",
        "cash_received",
        "cumulative_cash",
        "realized_fx",
        "remeasurement_fx",
        "cumulative_fx",
        "conservation_gap",
        "initial_carrying",
        "final_carrying",
        "final_foreign",
        "total_realized",
        "total_remeasurement",
        "total_cash",
        "total_fx"
      ],
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^(0|-?[1-9][0-9]{0,47})$",
              "maxLength": 49
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[1-9][0-9]{0,47}$",
              "maxLength": 48
            }
          },
          "required": [
            "n",
            "d"
          ],
          "additionalProperties": false
        },
        "minItems": 1,
        "maxItems": 6
      },
      "propertyNames": {
        "enum": [
          "remaining_foreign",
          "reference_rate",
          "carrying_value",
          "cash_received",
          "cumulative_cash",
          "realized_fx",
          "remeasurement_fx",
          "cumulative_fx",
          "conservation_gap",
          "initial_carrying",
          "final_carrying",
          "final_foreign",
          "total_realized",
          "total_remeasurement",
          "total_cash",
          "total_fx"
        ]
      },
      "patternProperties": {
        "^(initial_carrying|final_carrying|final_foreign|total_realized|total_remeasurement|total_cash|total_fx)$": {
          "type": "object",
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^(0|-?[1-9][0-9]{0,47})$",
              "maxLength": 49
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[1-9][0-9]{0,47}$",
              "maxLength": 48
            }
          },
          "required": [
            "n",
            "d"
          ],
          "additionalProperties": false
        }
      }
    }
  },
  "required": [
    "foreign_amount",
    "initial_rate_milli",
    "events",
    "report"
  ],
  "additionalProperties": {
    "type": "integer",
    "minimum": 1,
    "maximum": 1000000
  },
  "propertyNames": {
    "enum": [
      "foreign_amount",
      "initial_rate_milli",
      "events",
      "report"
    ]
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "foreign_amount": 100,
  "initial_rate_milli": 1000,
  "events": [
    {
      "op": 1,
      "foreign_received": 100,
      "rate_domain": [
        900
      ]
    }
  ],
  "report": {
    "remaining_foreign": [
      {
        "n": "0",
        "d": "1"
      }
    ],
    "reference_rate": [
      {
        "n": "1",
        "d": "1"
      }
    ],
    "carrying_value": [
      {
        "n": "0",
        "d": "1"
      }
    ],
    "cash_received": [
      {
        "n": "90",
        "d": "1"
      }
    ],
    "cumulative_cash": [
      {
        "n": "90",
        "d": "1"
      }
    ],
    "realized_fx": [
      {
        "n": "-10",
        "d": "1"
      }
    ],
    "remeasurement_fx": [
      {
        "n": "0",
        "d": "1"
      }
    ],
    "cumulative_fx": [
      {
        "n": "-10",
        "d": "1"
      }
    ],
    "conservation_gap": [
      {
        "n": "0",
        "d": "1"
      }
    ],
    "initial_carrying": {
      "n": "100",
      "d": "1"
    },
    "final_carrying": {
      "n": "0",
      "d": "1"
    },
    "final_foreign": {
      "n": "0",
      "d": "1"
    },
    "total_realized": {
      "n": "-10",
      "d": "1"
    },
    "total_remeasurement": {
      "n": "0",
      "d": "1"
    },
    "total_cash": {
      "n": "90",
      "d": "1"
    },
    "total_fx": {
      "n": "-10",
      "d": "1"
    }
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-07, 02:42 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →