Skip to content
HALOWERK

Finopswerk

foreign advance revenue rate bridge

Reconstructs one foreign-currency contract fully performed at one point in time, with two nonmonetary customer advances before performance and the remaining receivable first recognized at performance. Each advance keeps its own historical FX rate; only the unpaid portion uses the delivery spot rate. Revenue = advance1 * its rate + advance2 * its rate + unpaid * delivery rate. Returns 15 exact fractions; the rate-difference diagnostic is not an FX gain or loss.

POST https://finops.halowerk.com/v1/foreign-advance-revenue-rate-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
contract_foreign_nintegerYes
advance1_foreign_nintegerYes
advance2_foreign_nintegerYes
advance1_rate_nintegerYes
advance2_rate_nintegerYes
delivery_rate_domain_narrayYes
rate_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "contract_foreign_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "advance1_foreign_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "advance2_foreign_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "advance1_rate_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "advance2_rate_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "delivery_rate_domain_n": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10000
      }
    },
    "rate_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 15,
      "maxProperties": 15,
      "propertyNames": {
        "enum": [
          "contract_foreign",
          "advance1_foreign",
          "advance2_foreign",
          "unpaid_foreign",
          "advance1_historical_value",
          "advance2_historical_value",
          "nonmonetary_liability_released",
          "receivable_initial_value",
          "revenue_recognized",
          "all_at_delivery_value",
          "incorrect_remeasurement_difference",
          "advance1_rate_difference",
          "advance2_rate_difference",
          "revenue_bridge_gap",
          "rate_difference_bridge_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "n",
          "d"
        ],
        "properties": {
          "n": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          },
          "d": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          }
        }
      }
    }
  },
  "required": [
    "contract_foreign_n",
    "advance1_foreign_n",
    "advance2_foreign_n",
    "advance1_rate_n",
    "advance2_rate_n",
    "delivery_rate_domain_n",
    "rate_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "contract_foreign_n": 7,
  "advance1_foreign_n": 1,
  "advance2_foreign_n": 2,
  "advance1_rate_n": 1,
  "advance2_rate_n": 2,
  "delivery_rate_domain_n": [
    3
  ],
  "rate_denominator": 7,
  "report": {
    "contract_foreign": {
      "n": "7",
      "d": "1"
    },
    "advance1_foreign": {
      "n": "1",
      "d": "1"
    },
    "advance2_foreign": {
      "n": "2",
      "d": "1"
    },
    "unpaid_foreign": {
      "n": "4",
      "d": "1"
    },
    "advance1_historical_value": {
      "n": "1",
      "d": "7"
    },
    "advance2_historical_value": {
      "n": "4",
      "d": "7"
    },
    "nonmonetary_liability_released": {
      "n": "5",
      "d": "7"
    },
    "receivable_initial_value": {
      "n": "12",
      "d": "7"
    },
    "revenue_recognized": {
      "n": "17",
      "d": "7"
    },
    "all_at_delivery_value": {
      "n": "3",
      "d": "1"
    },
    "incorrect_remeasurement_difference": {
      "n": "4",
      "d": "7"
    },
    "advance1_rate_difference": {
      "n": "2",
      "d": "7"
    },
    "advance2_rate_difference": {
      "n": "2",
      "d": "7"
    },
    "revenue_bridge_gap": {
      "n": "0",
      "d": "1"
    },
    "rate_difference_bridge_gap": {
      "n": "0",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’