Download the PHP package emizoripx/clientfel without Composer

CLIENT FEL PACKAGE

Client for consuming services in FEL, for invoicing

Fresh installation

STEP 1

• php artisan migrate for creating new tables of package
• php artisan vendor:publish and choose option EmizorIpx\ClientFel\ClientFelServiceProvider on the list

  STEP 2

• go to app/config/clientfel.php and change value of api_url of FEL and routes of class INVOICE , ACCOUNT and PRODUCT

• got to routes/api.php and insert inside group prefix 'api/v1'

• got to app/Models/Invoices.php and add use InvoiceFelTrait;
• got to app/Repositories/BaseRepository.php

STEP 3

go to App\Http\Requests\Account\CreateAccountRequest and add the following code:

Update library

• run
  • composer update emizoripx/clientfel
  • if there is some problem remove library composer remove emizorip/clientfel
  • and install it composer require emizoripx/clientfel
• check if existe methods and routes inserted as above in step 2

API's

• GET TOKENS /api/v1/clientfel/getToken/ by default gets ID from company logged in by user

• REGISTER CREDENTIALS /api/v1/clientfel/registerCredentials additionally it updates the register if account_id is already registered
  • json : { "client_id" : "300001", "client_secret" : "PDAYQ59drtn4wSOxIz9gYfbBNrXx4ibkneKCtk5A"} after register is executed getToken
• REGISTER SETTINGS /api/v1/clientfel/settings
  • json : { "setting": { "activity_id": 474000, "caption_id": 45, "payment_method_id": 1 } }

// This is not available for now, homologate endpoint now is done inside creation of product

• HOMOLOGATE PRODUCTS

  • [POST]/api/v1/clientfel/homologateProduct
    • json : { "codigo_producto" : 12, "codigo_producto_sin": 83141, "codigo_unidad" : 1, "nombre_unidad" : "unidad" } codigo_product_sin must exists in SIN list products
• GET PARAMETRICS
  • [GET] /api/v1/clientfel/parametricas/motivo-anulacion
  • [GET] /api/v1/clientfel/parametricas/paises
  • [GET] /api/v1/clientfel/parametricas/tipos-documento-de-identidad
  • [GET] /api/v1/clientfel/parametricas/metodos_de_pago
  • [GET] /api/v1/clientfel/parametricas/monedas
  • [GET] /api/v1/clientfel/parametricas/unidades
  • [GET] /api/v1/clientfel/parametricas/actividades
  • [GET] /api/v1/clientfel/parametricas/leyendas
  • [GET] /api/v1/clientfel/parametricas/productos-sin

• EMIT INVOICE

  • [POST] /api/v1/clientfel/invoices
    json_body : {"id_origin": "xYRdG7dDzO"} , este campo es el id de la tabla invoice respuesta : {"success": true}
• CHECK FOR ERRORES DESDE LA WEB
  • [HOST]/bitacora

    FEL data appended

• Data will be appeneded in data response from file App\Http\Controllers\BaseController; it is necessary to include as an query argument include_fel_data with value=true

• This Appended contains this structure:

Added rule to check Product and Client Data

• Added a rule to validate if the product exists in the validation file App\Http\Requests\Shop\StoreShopInvoiceRequest;

Added rule to validate Client Data

• Added a rule to validate client data in the validation file App\Http\Requests\Shop\StoreShopClientRequest;

Insert additional data in request Shop Invoices

• Added method to insert required data in shop invoice request in App\Http\Controllers\Shop\InvoiceController

Insert additional data in request Shop Client

• Added method to insert required data in shop client request in App\Http\Controllers\Shop\ClientController

Trait to emit invoice

• Added trait to emit invoice in App\Models\Invoice

• Added function to emit invoice in App\Http\Controllers\Shop\InvoiceController

Added middleware CheckSettings

• A middleware was added to verify the parametric settings in route shop

Usage of commands in artisan

• php artisan emizor:make-patch [name of file patch] this command will generate a file that will be executed as migrations. This files will be stored in src\Patches

  Example: php artisan emizor:make-patch update_new_columns_fel_database

• php artisan emizor:patch this command will executed all files in patches folder, and it will be executed once for file, because every time this command is executed it will be saved in database