Updated schema for totals endpoint

app/uk/gov/hmrc/epayeapi/models/TotalsResponse.scala

@@ -20,15 +20,14 @@ import uk.gov.hmrc.domain.EmpRef
 import uk.gov.hmrc.epayeapi.models.domain.AggregatedTotals
 
 case class TotalsResponse(
-  empRef: EmpRef,
   credit: BigDecimal,
   debit: BigDecimal,
   _links: TotalsLinks
 )
 
 object TotalsResponse {
   def apply(empRef: EmpRef, totals: AggregatedTotals): TotalsResponse =
-    TotalsResponse(empRef, totals.credit, totals.debit, TotalsLinks())
+    TotalsResponse(totals.credit, totals.debit, TotalsLinks())
 }
 
 case class TotalsLinks(

resources/public/api/conf/1.0/application.raml

@@ -56,3 +56,29 @@ types:
                     "code" : "INSUFFICIENT_ENROLMENTS",
                     "message" : "You are not currently enrolled for ePAYE"
                   }
+
+/epaye/:EmpRef/total:
+  get:
+    is: [ headers.acceptHeader ]
+    displayName: Total balance
+    description: This resource returns the outstanding credits and debits on your account.
+    (annotations.scope): "read:epaye"
+    securedBy: [ sec.oauth_2_0: { scopes: [ "read:epaye" ] } ]
+    responses:
+      200:
+        body:
+          application/json:
+            type: !include schemas/Totals.get.schema.json
+            example: !include examples/Totals.get.json
+      401:
+        body:
+          application/json:
+            type: !include schemas/ErrorCodes.schema.json
+            examples:
+              notOpenStatus:
+                description: You don't have currently an ePAYE enrolment on this account.
+                value: |
+                  {
+                    "code" : "INSUFFICIENT_ENROLMENTS",
+                    "message" : "You are not currently enrolled for ePAYE"
+                  }

resources/public/api/conf/1.0/examples/Totals.get.json

@@ -0,0 +1,10 @@
+{
+  "empRef" : "840/GZ00064",
+  "credit" : 100,
+  "debit" : 0,
+  "_links" : {
+    "empRefs" : {
+      "href" : "/"
+    }
+  }
+}

resources/public/api/conf/1.0/schemas/Totals.get.schema.json

@@ -0,0 +1,30 @@
+{
+  "type": "object",
+  "description": "An object containing the outstanding debits and outstanding credits",
+  "properties": {
+    "_links": {
+      "type": "object",
+      "description": "An object of links to explore further data",
+      "properties": {
+        "empRefs": {
+          "type": "object",
+          "description": "An object holding the link back to the entry endpoint",
+          "properties": {
+            "href": {
+              "type": "string",
+              "description": "Link to the entry endpoint"
+            }
+          }
+        }
+      }
+    },
+    "credit": {
+      "type": "integer",
+      "description": "The currently outstanding credits on your account."
+    },
+    "debit": {
+      "type": "integer",
+      "description": "The currently outstanding debits on your account."
+    }
+  }
+}