@snokam/mcp-api 0.158.0 → 0.160.0

package/specs/test/accounting.json

@@ -2326,6 +2326,482 @@
         ]
       }
     },
+    "/v1.0/reinvoicing/subcontractor/draft": {
+      "post": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Creates a draft re-invoice from a subcontractor supplier invoice",
+        "description": "Takes an incoming supplier invoice (bilag) in PowerOffice, marks up each line by the subcontractor cut, and creates a DRAFT outgoing invoice to the end customer. The draft is never sent — a human reviews and sends it.",
+        "operationId": "CreateSubcontractorInvoiceDraft",
+        "requestBody": {
+          "description": "The PowerOffice supplier-invoice (bilag) id to re-invoice.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/subcontractorInvoiceRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Draft invoice created with computed lines.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/subcontractorInvoiceResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Invalid input, no approved project hours, or a project missing a rate/customer.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/subcontractor": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Lists configured subcontractors",
+        "description": "Subcontractors configured for re-invoicing (supplierCode, cutPercent, customerCode fallback), sourced from Sanity.",
+        "operationId": "GetSubcontractors",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SubcontractorConfig",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/subcontractorConfig"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/subcontractor/{supplierCode}/invoices": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Lists a subcontractor's incoming invoices for a month",
+        "description": "The month's PowerOffice bilag (incoming supplier invoices) for the given supplier, for the review page to select from before generating drafts.",
+        "operationId": "GetSubcontractorSourceInvoices",
+        "parameters": [
+          {
+            "name": "supplierCode",
+            "in": "path",
+            "description": "PowerOffice supplier code",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          {
+            "name": "year",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "month",
+            "in": "query",
+            "description": "1-12",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SubcontractorSourceInvoiceSummary",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/subcontractorSourceInvoiceSummary"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/subcontractor/{supplierCode}/drafts": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Lists a subcontractor's generated draft re-invoices for a month",
+        "description": "Draft outgoing invoices already generated for the supplier's bilag in the given month, matched by the reinvoice:{bilagId} external reference.",
+        "operationId": "GetSubcontractorDrafts",
+        "parameters": [
+          {
+            "name": "supplierCode",
+            "in": "path",
+            "description": "PowerOffice supplier code",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          {
+            "name": "year",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "month",
+            "in": "query",
+            "description": "1-12",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SubcontractorDraftInvoiceSummary",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/subcontractorDraftInvoiceSummary"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/projects": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Lists all PowerOffice projects",
+        "description": "Projects available for the re-invoicing overview to select from.",
+        "operationId": "GetReinvoicingProjects",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of AccountingProject",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/accountingProject"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/projects/{projectCode}/subcontractors": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Lists a project's subcontractors with their incoming and outgoing invoices",
+        "description": "For the selected project and month: each subcontractor (supplier) that has incoming bilag on the project, together with those incoming invoices and the outgoing draft re-invoices generated from them.",
+        "operationId": "GetProjectSubcontractors",
+        "parameters": [
+          {
+            "name": "projectCode",
+            "in": "path",
+            "description": "PowerOffice project code",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "year",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "month",
+            "in": "query",
+            "description": "1-12",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of ProjectSubcontractor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/projectSubcontractor"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/subcontractor/overview": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Monthly fakturering per configured subcontractor",
+        "description": "For the given month: each configured subcontractor with its incoming supplier invoice total, outgoing re-invoice total and margin, for the overview table.",
+        "operationId": "GetSubcontractorMonthlyOverview",
+        "parameters": [
+          {
+            "name": "year",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "month",
+            "in": "query",
+            "description": "1-12",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SubcontractorMonthlySummary",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/subcontractorMonthlySummary"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/subcontractor/income": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Accumulated subcontractor re-invoicing income for a year",
+        "description": "Per-month incoming, outgoing and margin across the year, with the running accumulated margin, for the year-to-date income graph.",
+        "operationId": "GetSubcontractorAccumulatedIncome",
+        "parameters": [
+          {
+            "name": "year",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SubcontractorIncomePoint",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/subcontractorIncomePoint"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/voucher/{voucherId}/pdf": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Voucher documentation (PDF) for an invoice",
+        "description": "Base64-encoded documentation file attached to a voucher, for viewing the incoming supplier invoice or the outgoing re-invoice. Returns 404 when the voucher has no attached documentation.",
+        "operationId": "GetReinvoicingVoucherPdf",
+        "parameters": [
+          {
+            "name": "voucherId",
+            "in": "path",
+            "description": "PowerOffice voucher id (incoming supplier invoice or outgoing invoice)",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of VoucherDocument",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/voucherDocument"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/calculators/valuation": {
       "get": {
         "tags": [
@@ -2530,6 +3006,32 @@
           }
         }
       },
+      "accountingProject": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "startDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "endDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
       "accountingSalaryLine": {
         "type": "object",
         "properties": {
@@ -2824,6 +3326,9 @@
           "displayValue": {
             "type": "string"
           },
+          "description": {
+            "type": "string"
+          },
           "breakdown": {
             "type": "array",
             "items": {
@@ -2933,6 +3438,9 @@
           "displayValue": {
             "type": "string"
           },
+          "description": {
+            "type": "string"
+          },
           "breakdown": {
             "type": "array",
             "items": {
@@ -3293,6 +3801,9 @@
           "displayValue": {
             "type": "string"
           },
+          "description": {
+            "type": "string"
+          },
           "breakdown": {
             "type": "array",
             "items": {
@@ -3605,6 +4116,30 @@
           }
         }
       },
+      "projectSubcontractor": {
+        "type": "object",
+        "properties": {
+          "supplierCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "supplierName": {
+            "type": "string"
+          },
+          "incomingInvoices": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/subcontractorSourceInvoiceSummary"
+            }
+          },
+          "outgoingInvoices": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/subcontractorDraftInvoiceSummary"
+            }
+          }
+        }
+      },
       "provisionSalaryResult": {
         "required": [
           "salary",
@@ -4727,6 +5262,255 @@
           }
         }
       },
+      "subcontractorConfig": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "supplierCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "cutPercent": {
+            "type": "number",
+            "format": "double"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          }
+        }
+      },
+      "subcontractorDraftInvoiceSummary": {
+        "type": "object",
+        "properties": {
+          "supplierInvoiceId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "invoiceId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "totalAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "status": {
+            "type": "string"
+          }
+        }
+      },
+      "subcontractorIncomePoint": {
+        "type": "object",
+        "properties": {
+          "year": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "month": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "incoming": {
+            "type": "number",
+            "format": "double"
+          },
+          "outgoing": {
+            "type": "number",
+            "format": "double"
+          },
+          "margin": {
+            "type": "number",
+            "format": "double"
+          },
+          "accumulatedMargin": {
+            "type": "number",
+            "format": "double"
+          }
+        }
+      },
+      "subcontractorInvoiceDraft": {
+        "type": "object",
+        "properties": {
+          "customerCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "invoiceId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          }
+        }
+      },
+      "subcontractorInvoiceLine": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "quantity": {
+            "type": "number",
+            "format": "double"
+          },
+          "unitPrice": {
+            "type": "number",
+            "format": "double"
+          },
+          "amount": {
+            "type": "number",
+            "format": "double"
+          }
+        }
+      },
+      "subcontractorInvoiceRequest": {
+        "type": "object",
+        "properties": {
+          "supplierInvoiceId": {
+            "type": "string"
+          },
+          "variant": {
+            "type": "string"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "cutPercent": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          }
+        }
+      },
+      "subcontractorInvoiceResult": {
+        "type": "object",
+        "properties": {
+          "supplierInvoiceId": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "supplierCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "cutPercent": {
+            "type": "number",
+            "format": "double"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "totalAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "lines": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/subcontractorInvoiceLine"
+            }
+          },
+          "draft": {
+            "$ref": "#/components/schemas/subcontractorInvoiceDraft"
+          }
+        }
+      },
+      "subcontractorMonthlySummary": {
+        "type": "object",
+        "properties": {
+          "supplierCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          },
+          "cutPercent": {
+            "type": "number",
+            "format": "double"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "currency": {
+            "type": "string"
+          },
+          "incomingTotal": {
+            "type": "number",
+            "format": "double"
+          },
+          "outgoingTotal": {
+            "type": "number",
+            "format": "double"
+          },
+          "margin": {
+            "type": "number",
+            "format": "double"
+          },
+          "incomingCount": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "outgoingCount": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "subcontractorSourceInvoiceSummary": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "supplierCode": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "invoiceNo": {
+            "type": "string"
+          },
+          "voucherDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "projectCode": {
+            "type": "string"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "amount": {
+            "type": "number",
+            "format": "double"
+          },
+          "resolvedCustomerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          }
+        }
+      },
       "summary": {
         "type": "object",
         "properties": {
@@ -5171,6 +5955,20 @@
           }
         }
       },
+      "voucherDocument": {
+        "type": "object",
+        "properties": {
+          "fileName": {
+            "type": "string"
+          },
+          "contentBase64": {
+            "type": "string"
+          },
+          "contentType": {
+            "type": "string"
+          }
+        }
+      },
       "wageRate": {
         "required": [
           "sickLeave",