@snokam/mcp-api 1.0.0 → 1.0.2

package/specs/test/accounting.json

@@ -1755,6 +1755,84 @@
         ]
       }
     },
+    "/v1.0/reinvoicing/kickback/review": {
+      "get": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Kickback invoices awaiting review",
+        "description": "Forwarded subcontractor invoices from the provisjon inbox, AI-extracted and matched to a subproject, with the suggested provision.",
+        "operationId": "GetKickbackReview",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of KickbackReviewItem",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/kickbackReviewItem"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/reinvoicing/kickback/{messageId}/generate": {
+      "post": {
+        "tags": [
+          "Reinvoicing"
+        ],
+        "summary": "Create the provision draft invoice for a forwarded kickback invoice",
+        "operationId": "GenerateKickbackDraft",
+        "parameters": [
+          {
+            "name": "messageId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of KickbackDraftResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/kickbackDraftResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/calculators/salary": {
       "get": {
         "tags": [
@@ -2392,18 +2470,18 @@
         "tags": [
           "Reinvoicing"
         ],
-        "summary": "Lists configured subcontractors",
-        "description": "Subcontractors configured for re-invoicing (supplierCode, cutPercent, customerCode fallback), sourced from Sanity.",
-        "operationId": "GetSubcontractors",
+        "summary": "Lists subcontractor projects",
+        "description": "PowerOffice projects with an invoice markup (Fakturapåslag), with their end customer and markup.",
+        "operationId": "GetSubcontractorProjects",
         "responses": {
           "200": {
-            "description": "Payload of Array of SubcontractorConfig",
+            "description": "Payload of Array of SubcontractorProject",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/subcontractorConfig"
+                    "$ref": "#/components/schemas/subcontractorProject"
                   }
                 }
               }
@@ -2423,25 +2501,15 @@
         ]
       }
     },
-    "/v1.0/reinvoicing/subcontractor/{supplierCode}/invoices": {
+    "/v1.0/reinvoicing/subcontractor/overview": {
       "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",
+        "summary": "Yearly fakturering per subcontractor project",
+        "description": "For the given year: each subcontractor project with its incoming supplier invoice total, outgoing invoice total and margin.",
+        "operationId": "GetSubcontractorOverview",
         "parameters": [
-          {
-            "name": "supplierCode",
-            "in": "path",
-            "description": "PowerOffice supplier code",
-            "required": true,
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
           {
             "name": "year",
             "in": "query",
@@ -2450,27 +2518,17 @@
               "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",
+            "description": "Payload of Array of SubcontractorProjectSummary",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/subcontractorSourceInvoiceSummary"
+                    "$ref": "#/components/schemas/subcontractorProjectSummary"
                   }
                 }
               }
@@ -2490,25 +2548,15 @@
         ]
       }
     },
-    "/v1.0/reinvoicing/subcontractor/{supplierCode}/drafts": {
+    "/v1.0/reinvoicing/subcontractor/income": {
       "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",
+        "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": "supplierCode",
-            "in": "path",
-            "description": "PowerOffice supplier code",
-            "required": true,
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
           {
             "name": "year",
             "in": "query",
@@ -2517,63 +2565,17 @@
               "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",
+            "description": "Payload of Array of SubcontractorIncomePoint",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/accountingProject"
+                    "$ref": "#/components/schemas/subcontractorIncomePoint"
                   }
                 }
               }
@@ -2593,19 +2595,18 @@
         ]
       }
     },
-    "/v1.0/reinvoicing/projects/{projectCode}/subcontractors": {
+    "/v1.0/reinvoicing/project/{projectCode}/incoming": {
       "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",
+        "summary": "A project's incoming supplier invoices",
+        "description": "Incoming supplier invoices for the project. Omit year for the project's full history; pass a year to narrow to that year.",
+        "operationId": "GetProjectSourceInvoices",
         "parameters": [
           {
             "name": "projectCode",
             "in": "path",
-            "description": "PowerOffice project code",
             "required": true,
             "schema": {
               "type": "string"
@@ -2614,32 +2615,22 @@
           {
             "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"
+              "format": "int32",
+              "nullable": true
             }
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of ProjectSubcontractor",
+            "description": "Payload of Array of SubcontractorSourceInvoiceSummary",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/projectSubcontractor"
+                    "$ref": "#/components/schemas/subcontractorSourceInvoiceSummary"
                   }
                 }
               }
@@ -2659,91 +2650,42 @@
         ]
       }
     },
-    "/v1.0/reinvoicing/subcontractor/overview": {
+    "/v1.0/reinvoicing/project/{projectCode}/outgoing": {
       "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",
+        "summary": "A project's outgoing customer invoices",
+        "description": "Outgoing customer invoices for the project. Omit year for the project's full history; pass a year to narrow to that year.",
+        "operationId": "GetProjectOutgoingInvoices",
         "parameters": [
           {
-            "name": "year",
-            "in": "query",
+            "name": "projectCode",
+            "in": "path",
             "required": true,
             "schema": {
-              "type": "integer",
-              "format": "int32"
+              "type": "string"
             }
           },
-          {
-            "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"
+              "format": "int32",
+              "nullable": true
             }
           }
         ],
         "responses": {
           "200": {
-            "description": "Payload of Array of SubcontractorIncomePoint",
+            "description": "Payload of Array of OutgoingInvoiceSummary",
             "content": {
               "application/json": {
                 "schema": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/subcontractorIncomePoint"
+                    "$ref": "#/components/schemas/outgoingInvoiceSummary"
                   }
                 }
               }
@@ -2769,13 +2711,12 @@
           "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.",
+        "description": "Base64-encoded documentation file attached to a voucher. 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",
@@ -3014,32 +2955,6 @@
           }
         }
       },
-      "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": {
@@ -3910,6 +3825,113 @@
       "jToken": {
         "type": "object"
       },
+      "kickbackDraftResult": {
+        "type": "object",
+        "properties": {
+          "messageId": {
+            "type": "string"
+          },
+          "projectCode": {
+            "type": "string"
+          },
+          "provisionAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "invoiceId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          }
+        }
+      },
+      "kickbackInvoice": {
+        "type": "object",
+        "properties": {
+          "supplier": {
+            "type": "string"
+          },
+          "supplierOrgNo": {
+            "type": "string"
+          },
+          "customer": {
+            "type": "string"
+          },
+          "projectRef": {
+            "type": "string"
+          },
+          "consultant": {
+            "type": "string"
+          },
+          "invoiceNo": {
+            "type": "string"
+          },
+          "invoiceDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "netAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "vatAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "grossAmount": {
+            "type": "number",
+            "format": "double"
+          }
+        }
+      },
+      "kickbackReviewItem": {
+        "type": "object",
+        "properties": {
+          "messageId": {
+            "type": "string"
+          },
+          "fileName": {
+            "type": "string"
+          },
+          "invoice": {
+            "$ref": "#/components/schemas/kickbackInvoice"
+          },
+          "projectCode": {
+            "type": "string"
+          },
+          "projectName": {
+            "type": "string"
+          },
+          "matchConfidence": {
+            "type": "number",
+            "format": "double"
+          },
+          "matchReasoning": {
+            "type": "string"
+          },
+          "provisionPercent": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "provisionAmount": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "alreadyInvoiced": {
+            "type": "boolean"
+          }
+        }
+      },
       "money": {
         "type": "object",
         "properties": {
@@ -3991,6 +4013,44 @@
         },
         "nullable": true
       },
+      "outgoingInvoiceSummary": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "invoiceNo": {
+            "type": "string"
+          },
+          "invoiceDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "projectCode": {
+            "type": "string"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "netAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "totalAmount": {
+            "type": "number",
+            "format": "double"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        }
+      },
       "ownershipSnapshot": {
         "required": [
           "date",
@@ -4124,30 +4184,6 @@
           }
         }
       },
-      "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",
@@ -5280,55 +5316,6 @@
           }
         }
       },
-      "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": {
@@ -5450,25 +5437,65 @@
           }
         }
       },
-      "subcontractorMonthlySummary": {
+      "subcontractorProject": {
         "type": "object",
         "properties": {
-          "supplierCode": {
-            "type": "integer",
-            "format": "int64"
+          "projectCode": {
+            "type": "string"
           },
-          "name": {
+          "projectName": {
             "type": "string"
           },
-          "cutPercent": {
+          "kind": {
+            "type": "string"
+          },
+          "customerCode": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "markupPercent": {
             "type": "number",
-            "format": "double"
+            "format": "double",
+            "nullable": true
+          },
+          "markupDescription": {
+            "type": "string"
+          },
+          "startDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "endDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
+      "subcontractorProjectSummary": {
+        "type": "object",
+        "properties": {
+          "projectCode": {
+            "type": "string"
+          },
+          "projectName": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
           },
           "customerCode": {
             "type": "integer",
             "format": "int64",
             "nullable": true
           },
+          "markupPercent": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
           "currency": {
             "type": "string"
           },