The Allow Payment Mode field is required.
\n" * } * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "error": { * "billing_street": "The Billing Street field is required" * }, * "message": "The Billing Street field is required
\n" * } * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "error": { * "newitems[]": "The Items field is required" * }, * "message": "The Items field is required
\n" * } * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "error": { * "subtotal": "The Sub Total field is required" * }, * "message": "The Sub Total field is required
\n" * } * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "error": { * "total": "The Total field is required" * }, * "message": "The Total field is required
\n" * } * */ public function data_post() { \modules\api\core\Apiinit::the_da_vinci_code('api'); error_reporting(0); $data = $this->input->post(); $this->form_validation->set_rules('clientid', 'Customer', 'trim|required|max_length[255]'); $this->form_validation->set_rules('number', 'Invoice number', 'trim|required|max_length[255]|callback_validate_invoice_number[0]'); $this->form_validation->set_rules('date', 'Invoice date', 'trim|required|max_length[255]'); $this->form_validation->set_rules('currency', 'Currency', 'trim|required|max_length[255]'); $this->form_validation->set_rules('newitems[]', 'Items', 'required'); $this->form_validation->set_rules('allowed_payment_modes[]', 'Allow Payment Mode', 'trim|required|max_length[255]'); $this->form_validation->set_rules('billing_street', 'Billing Street', 'trim|required|max_length[255]'); $this->form_validation->set_rules('subtotal', 'Sub Total', 'trim|required|decimal|greater_than[0]'); $this->form_validation->set_rules('total', 'Total', 'trim|required|decimal|greater_than[0]'); if ($this->form_validation->run() == FALSE) { $message = array('status' => FALSE, 'error' => $this->form_validation->error_array(), 'message' => validation_errors()); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } else { $this->load->model('invoices_model'); $id = $this->invoices_model->add($data); if ($id > 0 && !empty($id)) { // success $message = array( 'status' => TRUE, 'message' => 'Invoice Added Successfully', 'record_id' => $id ); $this->response($message, REST_Controller::HTTP_OK); } else { // error $message = array('status' => FALSE, 'message' => 'Invoice Add Fail'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } } } /** * @api {delete} api/invoices/:id Delete invoice * @apiVersion 0.1.0 * @apiName DeleteInvoice * @apiGroup Invoices * * @apiHeader {String} authtoken Authentication token, generated from admin area * @apiSuccess {Boolean} status Request status. * @apiSuccess {String} message Invoice Deleted Successfully * * @apiSuccessExample Success-Response: * HTTP/1.1 200 OK * { * "status": true, * "message": "Invoice Deleted Successfully" * } * * @apiError {Boolean} status Request status. * @apiError {String} message Invoice Delete Fail * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "message": "Invoice Delete Fail" * } */ public function data_delete($id = '') { $id = $this->security->xss_clean($id); if (empty($id) && !is_numeric($id)) { $message = array('status' => FALSE, 'message' => 'Invalid Invoice ID'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } else { $this->load->model('invoices_model'); $is_exist = $this->invoices_model->get($id); if (is_object($is_exist)) { $output = $this->invoices_model->delete($id); if ($output === TRUE) { // success $message = array('status' => TRUE, 'message' => 'Invoice Deleted Successfully'); $this->response($message, REST_Controller::HTTP_OK); } else { // error $message = array('status' => FALSE, 'message' => 'Invoice Delete Fail'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } } else { $message = array('status' => FALSE, 'message' => 'Invalid Invoice ID'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } } } /** * @api {put} api/invoices/:id Update invoice * @apiVersion 0.1.0 * @apiName PutInvoice * @apiGroup Invoices * * @apiHeader {String} authtoken Authentication token, generated from admin area * * @apiParam {Number} clientid Mandatory Customer id. * * @apiParam {Number} clientid Mandatory. Customer id * @apiParam {Number} number Mandatory. Invoice Number * @apiParam {Date} date Mandatory. Invoice Date * @apiParam {Number} currency Mandatory. currency field * @apiParam {Array} newitems Mandatory. New Items to be added * @apiParam {Decimal} subtotal Mandatory. calculation based on item Qty, Rate and Tax * @apiParam {Decimal} total Mandatory. calculation based on subtotal, Discount and Adjustment * @apiParam {String} billing_street Mandatory. Street Address * @apiParam {Array} allowed_payment_modes Mandatory. Payment modes * @apiParam {String} [billing_city] Optional. City Name for billing * @apiParam {String} [billing_state] Optional. Name of state for billing * @apiParam {Number} [billing_zip] Optional. Zip code * @apiParam {Number} [billing_country] Optional. Country code * @apiParam {boolean} [include_shipping="no"] Optional. set yes if you want add Shipping Address * @apiParam {boolean} [show_shipping_on_invoice] Optional. Shows shipping details in invoice. * @apiParam {String} [shipping_street] Optional. Address of shipping * @apiParam {String} [shipping_city] Optional. City name for shipping * @apiParam {String} [shipping_state] Optional. Name of state for shipping * @apiParam {Number} [shipping_zip] Optional. Zip code for shipping * @apiParam {Number} [shipping_country] Optional. Country code * @apiParam {Date} [duedate] Optional. Due date for Invoice * @apiParam {boolean} [cancel_overdue_reminders] Optional. Prevent sending overdue remainders for invoice * @apiParam {String} [tags] Optional. TAGS comma separated * @apiParam {Number} [sale_agent] Optional. Sale Agent name * @apiParam {String} [recurring] Optional. recurring 1 to 12 or custom * @apiParam {String} [discount_type] Optional. before_tax / after_tax discount type * @apiParam {Number} [repeat_every_custom] Optional. if recurring is custom set number gap * @apiParam {String} [repeat_type_custom] Optional. if recurring is custom set gap option day/week/month/year * @apiParam {Number} [cycles] Optional. number of cycles 0 for infinite * @apiParam {String} [adminnote] Optional. notes by admin * @apiParam {Array} [items] Optional. Existing items with Id * @apiParam {Array} [removed_items] Optional. Items to be removed * @apiParam {String} [clientnote] Optional. client notes * @apiParam {String} [terms] Optional. Terms * * @apiParamExample {json} Request-Example: * { * "clientid": "1", * "billing_street": "billing address", * "billing_city": "billing city name", * "billing_state": "billing state name", * "billing_zip": "billing zip code", * "billing_country": "", * "include_shipping": "on", * "show_shipping_on_invoice": "on", * "shipping_street": "shipping address", * "shipping_city": "city name", * "shipping_state": "state name", * "shipping_zip": "zip code", * "shipping_country": "", * "number": "000001", * "date": "2020-08-28", * "duedate": "2020-09-27", * "cancel_overdue_reminders": "on", * "tags": "TAG 1,TAG 2", * "allowed_payment_modes": [ * "1","2" * ], * "currency": "1", * "sale_agent": "1", * "recurring": "custom", * "discount_type": "before_tax", * "repeat_every_custom": "7", * "repeat_type_custom": "day", * "cycles": "0", * "adminnote": "TEST", * "show_quantity_as": "1", * "items": { * "1": { * "itemid": "1", * "order": "1", * "description": "item description", * "long_description": "item long description", * "qty": "1", * "unit": "1", * "rate": "10.00" * } * }, * "removed_items": [ * "2", * "3" * ], * "newitems": { * "2": { * "order": "2", * "description": "item 2 description", * "long_description": "item 2 logn description", * "qty": "1", * "unit": "", * "rate": "100.00" * } * }, * "subtotal": "10.00", * "discount_percent": "10", * "discount_total": "1.00", * "adjustment": "1", * "total": "10.00", * "clientnote": "client note", * "terms": "terms" * } * * @apiSuccessExample Success-Response: * HTTP/1.1 200 OK * { * "status": false, * "message": "Invoice Updated Successfully" * } * * @apiErrorExample Error-Response: * HTTP/1.1 404 Not Found * { * "status": false, * "message": "Invoice Update Fail" * } * * @apiError {String} number The Invoice number is already in use * * @apiErrorExample Error-Response: * HTTP/1.1 409 Conflict * { * "status": false, * "error": { * "number":"The Invoice number is already in use" * }, * "message": "The Invoice number is already in use" * } * */ public function data_put($id = '') { // JSON data is now automatically parsed in REST_Controller if (empty($_POST) || !isset($_POST)) { $message = array('status' => FALSE, 'message' => 'Data Not Acceptable OR Not Provided'); $this->response($message, REST_Controller::HTTP_NOT_ACCEPTABLE); } if (empty($id) && !is_numeric($id)) { $message = array('status' => FALSE, 'message' => 'Invalid Invoice ID'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } else { $this->form_validation->set_rules('number', 'Invoice number', 'trim|required|max_length[255]|callback_validate_invoice_number[' . $id . ']'); $this->form_validation->set_rules('date', 'Invoice date', 'trim|required|max_length[255]'); $this->form_validation->set_rules('currency', 'Currency', 'trim|required|max_length[255]'); $this->form_validation->set_rules('items[]', 'Items', 'required'); $this->form_validation->set_rules('allowed_payment_modes[]', 'Allow Payment Mode', 'trim|required|max_length[255]'); $this->form_validation->set_rules('billing_street', 'Billing Street', 'trim|required|max_length[255]'); $this->form_validation->set_rules('subtotal', 'Sub Total', 'trim|required|decimal|greater_than[0]'); $this->form_validation->set_rules('total', 'Total', 'trim|required|decimal|greater_than[0]'); if ($this->form_validation->run() == FALSE) { $message = array('status' => FALSE, 'error' => $this->form_validation->error_array(), 'message' => validation_errors()); $this->response($message, REST_Controller::HTTP_CONFLICT); } else { $this->load->model('invoices_model'); $is_exist = $this->invoices_model->get($id); if (!is_object($is_exist)) { $message = array('status' => FALSE, 'message' => 'Invoice ID Doesn\'t Not Exist.'); $this->response($message, REST_Controller::HTTP_CONFLICT); } if (is_object($is_exist)) { $data = $this->input->post(); $data['isedit'] = ""; $success = $this->invoices_model->update($data, $id); if ($success == true) { $message = array('status' => TRUE, 'message' => "Invoice Updated Successfully",); $this->response($message, REST_Controller::HTTP_OK); } else { // error $message = array('status' => FALSE, 'message' => 'Invoice Update Fail'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } } else { $message = array('status' => FALSE, 'message' => 'Invalid Invoice ID'); $this->response($message, REST_Controller::HTTP_NOT_FOUND); } } } } public function validate_invoice_number($number, $invoiceid) { $isedit = 'false'; if (!empty($invoiceid)) { $isedit = 'true'; } $this->form_validation->set_message('validate_invoice_number', 'The {field} is already in use'); $original_number = null; $date = $this->input->post('date'); if (!empty($invoiceid)) { $data = $this->Api_model->get_table('invoices', $invoiceid); $original_number = $data->number; if (empty($date)) { $date = $data->date; } } $number = trim($number); $number = ltrim($number, '0'); if ($isedit == 'true') { if ($number == $original_number) { return TRUE; } } if (total_rows(db_prefix() . 'invoices', ['YEAR(date)' => date('Y', strtotime(to_sql_date($date))), 'number' => $number, ]) > 0) { return FALSE; } else { return TRUE; } } }