action envoice_estimation_api_new {
  label: "Create an estimation"
  provider: envoice
  method: POST
  path: "/api/estimation/new"
  encoding: form
  input: {
    type: "object"
    properties: {
      Attachments: {
        type: "array"
        description: "List of estimation attachments"
        items: {
          type: "object"
          properties: {
            Link: {
              type: "string"
              description: "Link to the file"
            }
            ObfuscatedFileName: {
              type: "string"
              description: "Hashed file name to avoid url wildguessing"
            }
            OriginalFileName: {
              type: "string"
              description: "Name of the file"
            }
            Size: {
              type: "integer"
              format: "int64"
              description: "File size number in bytes"
            }
            Type: {
              type: "string"
              description: "Type of the link (Attached or external)"
              enum: ["External", "Uploaded"]
            }
          }
        }
      }
      ClientId: {
        type: "integer"
        format: "int32"
        description: "The client to whom this estimation is assigned"
      }
      ClonedFromId: {
        type: "integer"
        format: "int32"
        description: "Indicate from which estimation this estimation has been cloned from"
      }
      CurrencyId: {
        type: "integer"
        format: "int32"
        description: "Id of the currency for the estimation amounts"
      }
      ExpiresOn: {
        type: "string"
        format: "date-time"
        description: "Indicates when the estimation will be proclamed as due"
      }
      IssuedOn: {
        type: "string"
        format: "date-time"
        description: "Indicates when the estimation was issued"
      }
      Items: {
        type: "array"
        description: "List of estimation items"
        items: {
          type: "object"
          properties: {
            Cost: {
              type: "number"
              format: "double"
              description: "Amount per unit"
            }
            Description: {
              type: "string"
              description: "Additional description attached to the estimation item"
            }
            DiscountPercentage: {
              type: "number"
              format: "double"
              description: "Discount percentage for the overall amount"
            }
            Quantity: {
              type: "number"
              format: "double"
              description: "Quantity in total used for the work type"
            }
            TaxId: {
              type: "integer"
              format: "int32"
              description: "Tax applied on the item"
            }
            TaxPercentage: {
              type: "number"
              format: "double"
              description: "Task percentage. Ex: 18%"
            }
            WorkTypeId: {
              type: "integer"
              format: "int32"
              description: "Work type (Name of the service)"
            }
          }
        }
      }
      Notes: {
        type: "string"
        description: "Internal note regarding the estimation"
      }
      Number: {
        type: "string"
        description: "Unique estimation number"
      }
      PaymentGateways: {
        type: "array"
        description: "List of enabled payment gateways for this estimation"
        items: {
          type: "object"
          properties: {
            Name: {
              type: "string"
              description: "Name of the payment gateway"
            }
          }
        }
      }
      PoNumber: {
        type: "string"
        description: "Unique number generated by the buyer"
      }
      Status: {
        type: "string"
        description: "Indicate the status of the estimation (paid/unpaid/overdue)"
        enum: ["Draft", "Accepted", "Rejected"]
      }
      Terms: {
        type: "string"
        description: "Terms of agreement"
      }
      "x-auth-key": {
        type: "string"
      }
      "x-auth-secret": {
        type: "string"
      }
    }
    required: ["x-auth-key", "x-auth-secret"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      AccessToken: {
        type: "string"
        description: "Security access token used for accessing the estimation anonymously"
      }
      Activities: {
        type: "array"
        description: "List of estimation activities. estimation audit log"
        items: {
          type: "object"
          properties: {
            EstimationNumber: {
              type: "string"
              description: "Indicates to which estimation this activity refers to"
            }
            Id: {
              type: "integer"
              format: "int32"
              description: "Id of estimation activity"
            }
            Link: {
              type: "string"
              description: "Url which point out to a certain activity action. Ex: Click to view the payment"
            }
            Message: {
              type: "string"
              description: "Message associated with the activity"
            }
            Type: {
              type: "string"
              description: "Type of the activity"
              enum: ["Created", "Draft", "Cloned", "SentViaEmail", "SentViaSms", "SentReminderViaEmail", "SentReminderViaSms", "Opened", "Viewed", "Rejected", "Updated", "Paid", "Unpaid", "Overdue", "NewManualPayment", "NewPaymentWithPaypal", "NewPaymentWithStripe", "NewPaymentWithPayoneer", "SentToAccountant", "DownloadedAsPdf", "MarkAsPaidByTheClient", "OpenedAttachment", "NewPaymentWithSquare", "NewPaymentWithKlikAndPay", "NewPaymentWithRazorpay", "NewPaymentWithWepay", "NewPaymentWithHalkbank", "ChangeStatus", "OrderUpdated", "OrderCreated", "NewPaymentWithTwoCheckout", "NewPaymentWithPaymentWall", "NewPaymentWithBamboraEU", "NewPaymentWithBamboraNA", "Void", "NewPaymentWithNlb", "NewPaymentWithAuthorizeNet", "NewPaymentWithBraintree", "EstimationCreated", "EstimationDraft", "EstimationCloned", "EstimationSentViaEmail", "EstimationOpened", "EstimationViewed", "EstimationAccepted", "EstimationRejected", "EstimationUpdated", "EstimationDownloadedAsPdf", "InvoiceDigitallySigned"]
            }
          }
        }
      }
      Attachments: {
        type: "array"
        description: "List of estimation attachments"
        items: {
          type: "object"
          properties: {
            Id: {
              type: "integer"
              format: "int32"
              description: "Id of estimation attachment"
            }
            Link: {
              type: "string"
              description: "Link to the file"
            }
            ObfuscatedFileName: {
              type: "string"
              description: "Hashed file name to avoid url wildguessing"
            }
            OriginalFileName: {
              type: "string"
              description: "Name of the file"
            }
            Size: {
              type: "integer"
              format: "int64"
              description: "File size number in bytes"
            }
            Type: {
              type: "string"
              description: "Type of the link (Attached or external)"
              enum: ["External", "Uploaded"]
            }
          }
        }
      }
      Client: {
        type: "object"
        properties: {
          AdditionalEmails: {
            type: "array"
            description: "Client additional emails contact for CC"
            items: {
              type: "object"
              properties: {
                Email: {
                  type: "string"
                  description: "CC"
                }
              }
            }
          }
          Address: {
            type: "string"
            description: "Client business address"
          }
          ClientCountryId: {
            type: "integer"
            format: "int32"
            description: "Indicates the country where the clients is from"
          }
          ClientCurrencyId: {
            type: "integer"
            format: "int32"
            description: "Indicates the default system currency used by the user for the client"
          }
          CompanyRegistrationNumber: {
            type: "string"
            description: "Client's Company Registration Number"
          }
          CreatedOn: {
            type: "string"
            format: "date-time"
            description: "Date of creation"
          }
          DefaultDueDateInDays: {
            type: "integer"
            format: "int32"
            description: "Client custom payment terms"
          }
          Email: {
            type: "string"
            description: "Client email"
          }
          Id: {
            type: "integer"
            format: "int32"
            description: "Entity id"
          }
          Name: {
            type: "string"
            description: "Name of the client"
          }
          PhoneNumber: {
            type: "string"
            description: "Client phone numer"
          }
          UiLanguageId: {
            type: "integer"
            format: "int32"
            description: "Hold a value of the language in which the invoice will be sent"
          }
          Vat: {
            type: "string"
            description: "Client's VAT number"
          }
        }
      }
      ClonedFromId: {
        type: "integer"
        format: "int32"
        description: "Indicate from which estimation this estimation has been cloned from"
      }
      Currency: {
        type: "object"
        properties: {
          Code: {
            type: "string"
            description: "Currency short numeric code"
          }
          Id: {
            type: "integer"
            format: "int32"
            description: "Entity id"
          }
          Name: {
            type: "string"
            description: "Name of the country"
          }
          Symbol: {
            type: "string"
            description: "Currency symbol"
          }
          Value: {
            type: "string"
            description: "Currency short alpha code"
          }
        }
      }
      DiscountAmount: {
        type: "number"
        format: "double"
        description: "Amount that goes as a discount"
      }
      ExpiresOn: {
        type: "string"
        format: "date-time"
        description: "Indicates when the estimation will be proclamed as due"
      }
      Id: {
        type: "integer"
        format: "int32"
        description: "Estimation id"
      }
      IssuedOn: {
        type: "string"
        format: "date-time"
        description: "Indicates when the estimation was issued"
      }
      Items: {
        type: "array"
        description: "List of estimation items"
        items: {
          type: "object"
          properties: {
            Cost: {
              type: "number"
              format: "double"
              description: "Amount per unit"
            }
            Description: {
              type: "string"
              description: "Additional description attached to the estimation item"
            }
            DiscountAmount: {
              type: "number"
              format: "double"
              description: "Amount that goes as a discount"
            }
            DiscountPercentage: {
              type: "number"
              format: "double"
              description: "Discount percentage for the overall amount"
            }
            Id: {
              type: "integer"
              format: "int32"
              description: "Id of estimation item"
            }
            Quantity: {
              type: "number"
              format: "double"
              description: "Quantity in total used for the work type"
            }
            SubTotalAmount: {
              type: "number"
              format: "double"
              description: "Sub-Total amount of the estimation item (Amount without tax)"
            }
            TaxAmount: {
              type: "number"
              format: "double"
              description: "Amount that goes to the tax"
            }
            TaxId: {
              type: "integer"
              format: "int32"
              description: "Tax applied on the item"
            }
            TaxPercentage: {
              type: "number"
              format: "double"
              description: "Task percentage. Ex: 18%"
            }
            TotalAmount: {
              type: "number"
              format: "double"
              description: "Total amount of the estimation item"
            }
            WorkTypeId: {
              type: "integer"
              format: "int32"
              description: "Work type (Name of the service)"
            }
          }
        }
      }
      Notes: {
        type: "string"
        description: "Internal note regarding the estimation"
      }
      Number: {
        type: "string"
        description: "Unique estimation number"
      }
      PaymentGateways: {
        type: "array"
        description: "List of enabled payment gateways for this estimation"
        items: {
          type: "object"
          properties: {
            Name: {
              type: "string"
              description: "Name of the payment gateway"
            }
          }
        }
      }
      PoNumber: {
        type: "string"
        description: "Unique number generated by the buyer"
      }
      Status: {
        type: "string"
        description: "Indicate the status of the estimation (paid/unpaid/overdue)"
        enum: ["Draft", "Accepted", "Rejected"]
      }
      SubTotalAmount: {
        type: "number"
        format: "double"
        description: "Total amount of the estimation without tax"
      }
      TaxAmount: {
        type: "number"
        format: "double"
        description: "Amount that goes to the tax"
      }
      Terms: {
        type: "string"
        description: "Terms of agreement"
      }
      TotalAmount: {
        type: "number"
        format: "double"
        description: "Total amount of the estimation with tax"
      }
    }
  }
}