Error response

Reason

403, Forbidden    

Invalid/unknown certificate is used
403, Forbidden, {
    "errors": [
        {
            "title": "Wrong platformId",
            "detail": "The reporter may not access the resource"
        }
    ]
}    
Unknown reporter not associated with report
400, Bad Request "Missing transaction and/or request id"     Transaction/request ID missing from web service call

422, Unprocessable Entity, {
    "errors": [
        {
            "title": "additionalProperties",
            "source": {
                "pointer": "#/data/attributes/filingData",
                "schemaLocation": "#/properties/data/properties/attributes/properties/filingData"
            },
            "detail": "#/data/attributes/filingData: extraneous key [xxx] is not permitted"
        },
    ]
}

422, Unprocessable Entity, {
    "errors": [
        {
            "title": "JsonParsingError",
            "detail": "org.apache.groovy.json.internal.Exceptions$JsonInternalException: unexpected character a"
        }
    ]
}

422, Unprocessable Entity, {
    "errors": [
        {
            "title": "required",
            "source": {
                "pointer": "#/data/attributes",
                "schemaLocation": "#/properties/data/properties/attributes"
            },
            "detail": "#/data/attributes: required key [sequenceNumber] not found"
        }
    ]
}

422, Unprocessable Entity, {
    "errors": [
        {
            "title": "enum",
            "source": {
                "pointer": "#/data/type"
            },
            "detail": "#/data/type: wrong-filing is not a valid enum value"
        }
    ]
}    

Data (payload) does not comply with the JSON structure
422, Unprocessable Entity, {
    "errors": [
        {
            "title": "additionalProperties",
            "source": {
                "pointer": "#/data/attributes/filingData/asset",
                "schemaLocation": "#/properties/data/properties/attributes/properties/filingData/properties/asset"
            },
            "detail": "#/data/attributes/filingData/asset: extraneous key [structuredAddress] is not permitted"
        },
    ]
}    
FilingType specified in URL and payload do not match
403, Forbidden, {
    "errors": [
        {
            "title": "Issue with personIdToken/platformId",
            "detail": "personIdToken/platformId mismatch"
        }
    ]
}    
PersonToken does not match the providers registered with the reporter
403, Forbidden, {
    "errors": [
        {
            "title": "Unknown platform",
            "detail": "Filing rejected, because the platform was not registered"
        }
    ]
}    
Reporter has no obligation (duty code 222)
403, Forbidden, {
    "errors": [
        {
            "title": "Issue with paymentYear",
            "detail": "The company does not have the correct code of duty for that year 2026"
        }
    ]
}
    
Reporter’s obligation has expired, or the obligation is not yet valid
422, Unprocessable Entity, {
    "errors": [
        {
            "title": "minimum",
            "source": {
                "pointer": "#/data/attributes/filingData/amount",
                "schemaLocation": "#/properties/data/properties/attributes/properties/filingData/properties/amount"
            },
            "detail": "#/data/attributes/filingData/amount: 0 is not greater or equal to 0.005"
        }
    ]
}
    
Payload cannot be validated. Read more about validation rules in appendix 8.

If the reporter would like to retrieve the reporting receipt, an API Endpoint that displays data must be called. This returns a list of reports (with filingReference) received, as well as an overall status of enrichment:

200, OK, {
    "data": [
    {
            "id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "type": "vehicle-filing-status",
            "attributes": {
                "filingReference": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                "status": "Success"
            },
            "links": {
                "self": "/platforms/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/years/2020/vehicle-filing-statuses/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                "filing": "/platforms/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/years/2020/vehicle-filings/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
            }
        },
        { 
         (osv.)       
        },

    ],
    "links": {
        "self": "/platforms/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/years/2020/boat-filing-statuses"
    }
}

By calling the endpoint with a specific FilingReference, you will get a response with all reporting data (same receipt as for the reporting itself).