### GET /websites/factiliza/ruc/establecimientos

Source: https://docs.factiliza.com/api-consulta/endpoint/ruc-anexo

Retrieves establishment details based on the provided RUC.

```APIDOC
## GET /websites/factiliza/ruc/establecimientos

### Description
Returns establishment details based on the provided RUC.

### Method
GET

### Endpoint
/websites/factiliza/ruc/establecimientos

### Parameters
#### Query Parameters
- **ruc** (string) - Required - The RUC (Registro Único de Contribuyentes) for which to retrieve establishment information.

### Request Example
GET /websites/factiliza/ruc/establecimientos?ruc=20100000001

### Response
#### Success Response (200)
- **data** (array) - A list of establishment objects.
  - **nombre_establecimiento** (string) - The name of the establishment.
  - **direccion** (string) - The address of the establishment.
  - **estado_establecimiento** (string) - The status of the establishment (e.g., 'ACTIVO', 'INACTIVO').
  - **actividad_principal** (string) - The primary activity of the establishment.

#### Response Example
```json
{
  "data": [
    {
      "nombre_establecimiento": "MI EMPRESA PRINCIPAL",
      "direccion": "AV. PRINCIPAL 123",
      "estado_establecimiento": "ACTIVO",
      "actividad_principal": "COMERCIO AL POR MAYOR"
    },
    {
      "nombre_establecimiento": "SUCURSAL NORTE",
      "direccion": "CALLE SECUNDARIA 456",
      "estado_establecimiento": "ACTIVO",
      "actividad_principal": "SERVICIOS DE CONSULTORIA"
    }
  ]
}
```
```

--------------------------------

### GET /websites/factiliza

Source: https://docs.factiliza.com/api-consulta/endpoint/sunat-guia

Retrieves detailed information about a specific electronic document (comprobante de pago electrónico - CPE) within the Factiliza system. This endpoint provides comprehensive data including sender, receiver, details of the document, associated events like 'baja' (cancellation), and audit information.

```APIDOC
## GET /websites/factiliza

### Description
Retrieves detailed information about a specific electronic document (comprobante de pago electrónico - CPE) within the Factiliza system. This endpoint provides comprehensive data including sender, receiver, details of the document, associated events like 'baja' (cancellation), and audit information.

### Method
GET

### Endpoint
/websites/factiliza

### Parameters
#### Query Parameters
- **id** (string) - Required - The unique identifier of the electronic document to retrieve.

### Request Example
(No request body for GET requests)

### Response
#### Success Response (200)
- **status** (string) - The status of the operation (e.g., "200").
- **message** (string) - A message indicating the success of the operation (e.g., "Exito").
- **data** (object) - An object containing the detailed information of the electronic document.
  - **id** (string) - The unique identifier of the document.
  - **codCpe** (string) - CPE code.
  - **numRuc** (string) - RUC number.
  - **cantidad** (null) - Quantity (currently null).
  - **codTipoCpe** (string) - CPE type code.
  - **numSerie** (string) - Serial number.
  - **observacion** (null) - Observation (currently null).
  - **numCpe** (string) - CPE number.
  - **codEstado** (string) - Status code (e.g., "02" for Baja).
  - **desEstado** (string) - Status description (e.g., "Baja").
  - **emision** (object) - Emission details.
    - **fecEmision** (string) - Emission date and time.
    - **indSEE** (string) - SEE indicator.
    - **indOrigen** (string) - Origin indicator.
    - **desNota** (null) - Note description.
    - **desHashQr** (string) - QR hash value.
    - **desQr** (string) - QR code URL.
    - **receptorObs** (null) - Receiver's observation.
    - **pse** (null) - PSE details.
    - **firma** (object) - Signature details.
      - **idCertificado** (string) - Certificate ID.
      - **digestValue** (string) - Digest value.
      - **fecFirma** (null) - Signature date.
    - **numIpCliente** (null) - Client IP address.
    - **numFecEmision** (string) - Emission date in numeric format.
    - **numRangoHora** (string) - Time range number.
  - **emisor** (object) - Issuer details.
    - **desNombre** (string) - Issuer's name.
    - **numAutorizacionMtc** (null) - MTС authorization number.
    - **indEncSunNumAutorizacionMtc** (null) - Indicator for MTС authorization number.
    - **indSubContratacion** (string) - Subcontracting indicator.
    - **autorizacion** (null) - Authorization details.
    - **subContratador** (null) - Subcontractor details.
  - **traslado** (object) - Transport details.
    - **codMotivoTraslado** (string) - Reason code for transport.
    - **desMotivoTraslado** (string) - Reason description for transport.
    - **desMotivoTrasladoOtros** (null) - Other reasons for transport.
    - **fecInicioTraslado** (string) - Transport start date and time.
    - **numPlacaVehiculo** (null) - Vehicle plate number.
    - **fecEntrega** (null) - Delivery date.
    - **indModalidadTraslado** (string) - Transport modality indicator.
    - **desModalidadTraslado** (string) - Transport modality description.
    - **indTrasladoVehiculo** (string) - Vehicle transport indicator.
    - **indTransbordo** (string) - Transshipment indicator.
    - **indRetornoVehicEnvEmbVacio** (string) - Indicator for returning empty vehicle.
    - **indRetornoVehicVacio** (string) - Indicator for returning empty vehicle.
    - **indPagadorFlete** (string) - Freight payer indicator.
    - **indTrasladoDua** (string) - DUA transport indicator.
    - **desTrasladoDua** (string) - DUA transport description.
    - **indTrasladoTotalBienes** (string) - Total goods transport indicator.
    - **numBultosPallets** (null) - Number of packages/pallets.
    - **desBien** (null) - Description of goods.
    - **codUnidadMedidaPb** (string) - Unit of measure for gross weight.
    - **numPesoBruto** (string) - Gross weight.
    - **numPesoBrutoItemsSel** (null) - Selected gross weight for items.
    - **desSustentoPesoBrutoItemsSel** (string) - Support for selected gross weight.
    - **contenedores** (null) - Container details.
    - **autorizacion** (null) - Authorization details.
    - **bien** (object) - Goods details.
      - **pagadorFlete** (null) - Freight payer.
      - **vehiculo** (array) - Vehicle details.
        - **indTipoVehiculo** (string) - Vehicle type indicator.
        - **desTipoVehiculo** (string) - Vehicle type description.
        - **numPlaca** (string) - Plate number.
        - **numTucChv** (null) - Tuc CHV number.
        - **indTucChv** (string) - Tuc CHV indicator.
        - **indEncSunNumTucChv** (string) - Indicator for Tuc CHV number.
        - **indFrecuente** (string) - Frequent indicator.
        - **indEncSunNumPlaca** (string) - Indicator for plate number.
        - **autorizacion** (null) - Authorization details.
      - **conductor** (array) - Driver details.
        - **indTipoOrden** (string) - Order type indicator.
        - **desTipoOrden** (string) - Order type description.
        - **codTipoDocIdentidad** (string) - ID document type code.
        - **desTipoDocIdentidad** (string) - ID document type description.
        - **numDocIdentidad** (string) - ID document number.
        - **numLicencia** (string) - License number.
        - **desNombre** (string) - Driver's name.
        - **codEmisorLicencia** (null) - License issuing authority.
        - **indFrecuente** (string) - Frequent indicator.
        - **indEncSunNumLicencia** (string) - Indicator for license number.
      - **proveedor** (null) - Supplier details.
      - **comprador** (object) - Buyer details.
        - **codTipoDocIdentidad** (string) - ID document type code.
        - **desTipoDocIdentidad** (string) - ID document type description.
        - **numDocIdentidad** (string) - ID document number.
        - **desNombre** (string) - Buyer's name.
        - **indFrecuente** (string) - Frequent indicator.
      - **transportista** (null) - Carrier details.
    - **receptor** (object) - Receiver details.
      - **codTipoDocIdentidad** (string) - ID document type code.
      - **desTipoDocIdentidad** (string) - ID document type description.
      - **numDocIdentidad** (string) - ID document number.
      - **desNombre** (string) - Receiver's name.
      - **indFrecuente** (string) - Frequent indicator.
    - **remitente** (null) - Sender details.
    - **docRelacionado** (null) - Related document details.
    - **docGrePorEvento** (null) - Document generated by event details.
    - **baja** (object) - Cancellation details.
      - **fecRegistro** (string) - Registration date and time of cancellation.
      - **codUsuario** (string) - User code who registered the cancellation.
      - **codMotivo** (string) - Cancellation reason code.
      - **desMotivo** (string) - Cancellation reason description.
    - **noConformidad** (null) - Non-conformity details.
    - **auditoria** (object) - Audit trail.
      - **codUsuRegis** (string) - User code who registered the record.
      - **fecRegis** (string) - Registration date and time of the record.
      - **codUsuModif** (string) - User code who modified the record.
      - **fecModif** (string) - Modification date and time of the record.
      - **numSchemaVersion** (string) - Schema version number.
  - **desTipoCpe** (string) - CPE type description (e.g., "sin evento").

#### Response Example
```json
{
  "status": "200",
  "message": "Exito",
  "data": {
    "id": "6644e0584375081e918a6e91",
    "codCpe": "09",
    "numRuc": "20538878309",
    "cantidad": null,
    "codTipoCpe": "00",
    "numSerie": "T004",
    "observacion": null,
    "numCpe": "9",
    "codEstado": "02",
    "desEstado": "Baja",
    "emision": {
      "fecEmision": "2024-05-15T00:00:00",
      "indSEE": "2",
      "indOrigen": "3",
      "desNota": null,
      "desHashQr": "dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
      "desQr": "https://e-factura.sunat.gob.pe/v1/contribuyente/gre/comprobante/descargaqr?hashqr=dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
      "receptorObs": null,
      "pse": null,
      "firma": {
        "idCertificado": "34b26f7af41589ac80",
        "digestValue": "4mt0ivPSpPdgqCYBS+fkIMuVKSU=",
        "fecFirma": null
      },
      "numIpCliente": null,
      "numFecEmision": "20240515",
      "numRangoHora": "0"
    },
    "emisor": {
      "desNombre": "INVERSIONES E & F AYALA Y ARIAS S.A.C.",
      "numAutorizacionMtc": null,
      "indEncSunNumAutorizacionMtc": null,
      "indSubContratacion": "0",
      "autorizacion": null,
      "subContratador": null
    },
    "traslado": {
      "codMotivoTraslado": "01",
      "desMotivoTraslado": "Venta",
      "desMotivoTrasladoOtros": null,
      "fecInicioTraslado": "2024-05-15T00:00:00",
      "numPlacaVehiculo": null,
      "fecEntrega": null,
      "indModalidadTraslado": "02",
      "desModalidadTraslado": "Privado",
      "indTrasladoVehiculo": "0",
      "indTransbordo": "0",
      "indRetornoVehicEnvEmbVacio": "0",
      "indRetornoVehicVacio": "0",
      "indPagadorFlete": "00",
      "indTrasladoDua": "0",
      "desTrasladoDua": "Parcial",
      "indTrasladoTotalBienes": "0",
      "numBultosPallets": null,
      "desBien": null,
      "codUnidadMedidaPb": "KGM",
      "numPesoBruto": "839.6",
      "numPesoBrutoItemsSel": null,
      "desSustentoPesoBrutoItemsSel": "",
      "contenedores": null,
      "autorizacion": null,
      "bien": {
        "pagadorFlete": null,
        "vehiculo": [
          {
            "indTipoVehiculo": "1",
            "desTipoVehiculo": "Principal",
            "numPlaca": "BUI721",
            "numTucChv": null,
            "indTucChv": "4",
            "indEncSunNumTucChv": "0",
            "indFrecuente": "0",
            "indEncSunNumPlaca": "0",
            "autorizacion": null
          }
        ],
        "conductor": [
          {
            "indTipoOrden": "1",
            "desTipoOrden": "Principal",
            "codTipoDocIdentidad": "1",
            "desTipoDocIdentidad": "DOCUMENTO NACIONAL DE IDENTIDAD",
            "numDocIdentidad": "40700608",
            "numLicencia": "Q40700608",
            "desNombre": "YAÑE GAMONAL YONE",
            "codEmisorLicencia": null,
            "indFrecuente": "0",
            "indEncSunNumLicencia": "1"
          }
        ],
        "proveedor": null,
        "comprador": {
          "codTipoDocIdentidad": "",
          "desTipoDocIdentidad": "",
          "numDocIdentidad": "",
          "desNombre": "",
          "indFrecuente": "0"
        },
        "transportista": null
      }
    },
    "receptor": {
      "codTipoDocIdentidad": "6",
      "desTipoDocIdentidad": "REGISTRO ÚNICO DE CONTRIBUYENTES",
      "numDocIdentidad": "20510631715",
      "desNombre": "S.I.G. SERVICIOS GENERALES E.I.R.L.",
      "indFrecuente": "0"
    },
    "remitente": null,
    "docRelacionado": null,
    "docGrePorEvento": null,
    "baja": {
      "fecRegistro": "2024-05-16T12:11:40",
      "codUsuario": "ERIKASAC",
      "codMotivo": "02",
      "desMotivo": "Con baja - Antes de iniciar el traslado "
    },
    "noConformidad": null,
    "auditoria": {
      "codUsuRegis": "ERIKASAC",
      "fecRegis": "2024-05-15T11:18:32",
      "codUsuModif": "ERIKASAC",
      "fecModif": "2024-05-16T12:11:40",
      "numSchemaVersion": "1.0"
    },
    "desTipoCpe": "sin evento"
  }
}
```
```

--------------------------------

### Configurar ServiceData2.php en QPos

Source: https://docs.factiliza.com/api-consulta/facturador-pro

Actualiza el archivo ServiceData2.php en QPos para integrar la API de Factiliza. Este script contiene la lógica para establecer la conexión y enviar las credenciales codificadas en Base64.

```php
<?php

eval("eval(base64_decode('bmFtZXNwYWNlIE1vZHVsZXNcQXBpUGVydURldlxEYXRhOwp1c2UgR3V6emxlSHR0cFxDbGllbnQ7CnVzZSBBcHBcTW9kZWxzXFN5c3RlbVxDb25maWd1cmF0aW9uIGFzIFN5c3RlbUNvbmZpZ3VyYXRpb247CgpjbGFzcyBTZXJ2aWNlRGF0YTIKewogICAgcHJvdGVjdGVkICRjbGllbnQ7CiAgICBwcm90ZWN0ZWQgJHBhcmFtZXRlcnM7CgogICAgcHVibGljIGZ1bmN0aW9uIF9fY29uc3RydWN0KCkKICAgIHsKICAgICAgICAkdXJsID0gImh0dHBzOi8vYXBpLmZhY3RpbGl6YS5jb20iOwogICAgICAgICRjb25maWd1cmF0aW9uID0gU3lzdGVtQ29uZmlndXJhdGlvbjo6cXVlcnkoKQogICAgICAgICAgICAtPnNlbGVjdCgidG9rZW5fYXBpcnVjIikKICAgICAgICAgICAgLT5maXJzdCgpOwogICAgICAgICR0aGlzLT5jbGllbnQgPSBuZXcgQ2xpZW50KFsiYmFzZV91cmkiID0+ICR1cmxdKTsKICAgICAgICAkdGhpcy0+cGFyYW1ldGVycyA9IFsKICAgICAgICAgICAgImh0dHBfZXJyb3JzIiA9PiBmYWxzZSwKICAgICAgICAgICAgImNvbm5lY3RfdGltZW91dCIgPT4gMywKICAgICAgICAgICAgInZlcmlmeSIgPT4gZmFsc2UsCiAgICAgICAgICAgICJoZWFkZXJzIiA9PiBbCiAgICAgICAgICAgICAgICAiQXV0aG9yaXphdGlvbiIgPT4gIkJlYXJlciAiIC4gJGNvbmZpZ3VyYXRpb24tPnRva2VuX2FwaXJ1YywKICAgICAgICAgICAgICAgICJBY2NlcHQiID0+ICJhcHBsaWNhdGlvbi9qc29uIiwKICAgICAgICAgICAgXSwKICAgICAgICBdOwogICAgfQp9'));");

```

--------------------------------

### GET /cee/info/{cee}

Source: https://docs.factiliza.com/api-consulta/endpoint/cee

Retrieves detailed information based on the provided Carnet de Extranjería number.

```APIDOC
## GET /cee/info/{cee}

### Description
Retrieves detailed information based on the provided Carnet de Extranjería number.

### Method
GET

### Endpoint
https://api.factiliza.com/v1/cee/info/{cee}

### Parameters
#### Path Parameters
- **cee** (string) - Required - El carnet de extranjeria a consultar

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **status** (integer) - El código de estado de la respuesta
- **success** (boolean) - El estado de la respuesta true o false
- **message** (string) - Mensaje de la respuesta
- **data** (object) - Datos detallados de la respuesta
  - **numero** (string) - Numero del cee de la persona
  - **nombres** (string) - Nombres de la persona
  - **apellido_paterno** (string) - Apellido paterno de la persona
  - **apellido_materno** (string) - Apellido materno de la persona

#### Response Example
```json
{
  "status": 200,
  "message": "Exito",
  "data": {
    "numero": "001077238",
    "nombres": "ARCILA",
    "apellido_paterno": "LUZ CELIA KORINA",
    "apellido_materno": "RIVADENEIRA"
  }
}
```

#### Error Response (400)
- **status** (integer) - The HTTP status code.
- **success** (boolean) - Indicates if the request was successful.
- **message** (string) - A message describing the error.

#### Error Response Example
```json
{
  "status": 400,
  "success": false,
  "message": "Bad Request"
}
```
```

--------------------------------

### Create Invoice

Source: https://docs.factiliza.com/api-facturacion/endpoint/invoice/send

Creates a new invoice with detailed information about the products, taxes, and payment methods.

```APIDOC
## POST /websites/factiliza

### Description
This endpoint allows you to create a new invoice. It requires detailed information about the transaction, including product details, tax calculations, payment methods, and legends.

### Method
POST

### Endpoint
/websites/factiliza

### Parameters
#### Request Body
- **tipo_Operacion** (string) - Required - Type of operation.
- **tipo_Doc** (string) - Required - Type of document.
- **serie** (string) - Required - Document series.
- **correlativo** (string) - Required - Document correlative number.
- **tipo_Moneda** (string) - Required - Currency type.
- **fecha_Emision** (string) - Required - Date of emission (ISO 8601 format).
- **empresa_Ruc** (string) - Required - Company RUC (tax identification number).
- **cliente_Tipo_Doc** (string) - Required - Customer's document type.
- **cliente_Num_Doc** (string) - Required - Customer's document number.
- **cliente_Razon_Social** (string) - Required - Customer's legal name.
- **cliente_Direccion** (string) - Required - Customer's address.
- **monto_Oper_Gravadas** (number) - Required - Taxable operation amount.
- **monto_Igv** (number) - Required - IGV (VAT) amount.
- **total_Impuestos** (number) - Required - Total taxes amount.
- **valor_Venta** (number) - Required - Sales value.
- **sub_Total** (number) - Required - Subtotal amount.
- **monto_Imp_Venta** (number) - Required - Sales tax amount.
- **detalle** (array) - Required - Details of the products sold.
  - **unidad** (string) - Required - Unit of measurement.
  - **cantidad** (number) - Required - Quantity.
  - **cod_Producto** (string) - Required - Product code.
  - **descripcion** (string) - Required - Product description.
  - **monto_Valor_Unitario** (number) - Required - Unit value amount.
  - **monto_Base_Igv** (number) - Required - Base IGV amount per unit.
  - **porcentaje_Igv** (number) - Required - IGV percentage per unit.
  - **igv** (number) - Required - IGV amount per unit.
  - **tip_Afe_Igv** (string) - Required - IGV affectation type code (from SUNAT catalog).
  - **total_Impuestos** (number) - Required - Total taxes per unit.
  - **monto_Precio_Unitario** (number) - Required - Unit price amount.
  - **monto_Valor_Venta** (number) - Required - Sales value per unit.
  - **factor_Icbper** (number) - Optional - ICBP per unit factor.
- **forma_pago** (array) - Required - List of payment forms.
  - **tipo** (string) - Required - Payment type (CONTADO or CREDITO).
  - **monto** (number) - Required - Payment amount.
  - **cuota** (number) - Optional - Installment number for credit payments.
  - **fecha_Pago** (string) - Required - Payment date (ISO 8601 format).
- **legend** (array) - Required - List of legends.
  - **legend_Code** (string) - Required - Legend code.
  - **legend_Value** (string) - Required - Legend value.

### Request Example
```json
{
  "tipo_Operacion": "<string>",
  "tipo_Doc": "<string>",
  "serie": "<string>",
  "correlativo": "<string>",
  "tipo_Moneda": "<string>",
  "fecha_Emision": "2023-11-07T05:31:56Z",
  "empresa_Ruc": "<string>",
  "cliente_Tipo_Doc": "<string>",
  "cliente_Num_Doc": "<string>",
  "cliente_Razon_Social": "<string>",
  "cliente_Direccion": "<string>",
  "monto_Oper_Gravadas": 123,
  "monto_Igv": 123,
  "total_Impuestos": 123,
  "valor_Venta": 123,
  "sub_Total": 123,
  "monto_Imp_Venta": 123,
  "detalle": [
    {
      "unidad": "<string>",
      "cantidad": 1,
      "cod_Producto": "<string>",
      "descripcion": "<string>",
      "monto_Valor_Unitario": 100,
      "monto_Base_Igv": 100,
      "porcentaje_Igv": 18,
      "igv": 18,
      "tip_Afe_Igv": "10",
      "total_Impuestos": 18,
      "monto_Precio_Unitario": 118,
      "monto_Valor_Venta": 100,
      "factor_Icbper": 0
    }
  ],
  "forma_pago": [
    {
      "tipo": "CONTADO",
      "monto": 118,
      "fecha_Pago": "2023-11-07T05:31:56Z"
    }
  ],
  "legend": [
    {
      "legend_Code": "1000",
      "legend_Value": "SON: CIEN Y 00/100 SOLES"
    }
  ]
}
```

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the operation.
- **message** (string) - A message confirming the invoice creation.

#### Response Example
```json
{
  "status": "success",
  "message": "Invoice created successfully"
}
```
```

--------------------------------

### GET /ruc/representante/{ruc}

Source: https://docs.factiliza.com/api-consulta/endpoint/ruc-representante

Fetches representative details for a specified RUC. Requires Bearer token authentication.

```APIDOC
## GET /ruc/representante/{ruc}

### Description
Retrieves representative information based on the provided RUC.

### Method
GET

### Endpoint
/ruc/representante/{ruc}

### Parameters
#### Path Parameters
- **ruc** (integer) - Required - The RUC to consult.

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **status** (integer) - The status code of the response.
- **success** (boolean) - The status of the response (true or false).
- **message** (string) - Message of the response.
- **data** (array) - Detailed data of the response. Each item in the array is an object with the following properties:
  - **tipo_de_documento** (string) - Document type of the representative.
  - **numero_de_documento** (string) - Document number of the representative.
  - **nombre** (string) - Name of the representative.
  - **cargo** (string) - Position of the representative.
  - **fecha_desde** (string) - Start date.

#### Response Example
```json
{
  "status": 200,
  "message": "Exito",
  "data": [
    {
      "tipo_de_documento": "DNI",
      "numero_de_documento": "1*****72",
      "nombre": "PAIMO *****O ***NA",
      "cargo": "GERENTE GENERAL",
      "fecha_desde": "30/09/2002"
    }
  ]
}
```

#### Error Response (400)
- **status** (integer) - Status code.
- **success** (boolean) - Indicates if the request was successful.
- **message** (string) - Error message.

#### Error Response Example
```json
{
  "status": 400,
  "success": false,
  "message": "Bad Request"
}
```
```

--------------------------------

### POST /websites/factiliza

Source: https://docs.factiliza.com/api-facturacion/endpoint/invoice/send

This endpoint is used to add a new plant to the store. It processes document details, payment information, and legend data, then sends it for validation with SUNAT.

```APIDOC
## POST /websites/factiliza

### Description
This endpoint allows you to add a new plant to the store. It takes detailed information about the document, including itemized details, payment methods, and legends. The system validates this information and sends it to SUNAT for further processing.

### Method
POST

### Endpoint
/websites/factiliza

### Parameters
#### Request Body
- **monto_Oper_Exoneradas** (integer) - Optional - The amount of exempted operations.
- **estado_Documento** (string) - Optional - The status of the document.
- **manual** (boolean) - Optional - Indicates if the document was entered manually.
- **id_Base_Dato** (string) - Optional - The ID of the database.
- **detalle** (array) - Required - An array of objects, where each object represents a detail of the items in the document.
  - **unidad** (string) - Optional - Unit of measure.
  - **cantidad** (integer) - Required - Quantity of the item.
  - **cod_Producto** (string) - Required - Product code.
  - **descripcion** (string) - Required - Description of the product.
  - **monto_Valor_Unitario** (number) - Required - Unit value amount.
  - **monto_Base_Igv** (number) - Required - Base IGV amount.
  - **porcentaje_Igv** (number) - Required - IGV percentage.
  - **igv** (number) - Required - IGV amount.
  - **tip_Afe_Igv** (string) - Required - IGV affectation type.
  - **total_Impuestos** (number) - Required - Total taxes.
  - **monto_Precio_Unitario** (number) - Required - Unit price amount.
  - **monto_Valor_Venta** (number) - Required - Sales value amount.
  - **factor_Icbper** (number) - Optional - ICPer factor.
- **forma_pago** (array) - Required - An array of payment objects.
  - **tipo** (string) - Required - Payment type.
  - **monto** (number) - Required - Payment amount.
  - **cuota** (number) - Optional - Payment installment amount.
  - **fecha_Pago** (string) - Optional - Payment date (ISO 8601 format).
- **legend** (array) - Optional - An array of legend objects.
  - **legend_Code** (string) - Required - Legend code.
  - **legend_Value** (string) - Required - Legend value.

### Request Example
```json
{
  "monto_Oper_Exoneradas": 123,
  "estado_Documento": "<string>",
  "manual": true,
  "id_Base_Dato": "<string>",
  "detalle": [
    {
      "unidad": "<string>",
      "cantidad": 123,
      "cod_Producto": "<string>",
      "descripcion": "<string>",
      "monto_Valor_Unitario": 123,
      "monto_Base_Igv": 123,
      "porcentaje_Igv": 123,
      "igv": 123,
      "tip_Afe_Igv": "<string>",
      "total_Impuestos": 123,
      "monto_Precio_Unitario": 123,
      "monto_Valor_Venta": 123,
      "factor_Icbper": 123
    }
  ],
  "forma_pago": [
    {
      "tipo": "<string>",
      "monto": 123,
      "cuota": 123,
      "fecha_Pago": "2023-11-07T05:31:56Z"
    }
  ],
  "legend": [
    {
      "legend_Code": "<string>",
      "legend_Value": "<string>"
    }
  ]
}
```

### Response
#### Success Response (200)
- **status** (integer) - The HTTP status code.
- **success** (boolean) - Indicates if the operation was successful.
- **message** (string) - A message describing the result of the operation.
- **data** (object) - Contains the response data from SUNAT.
  - **hash** (string) - Hash of the generated document.
  - **sunatResponse** (object) - Response details from SUNAT.
    - **success** (boolean) - Indicates if SUNAT accepted the document.
    - **cdrZip** (string) - CDR of the document compressed in base64 format.
    - **cdrResponse** (object) - The response object from SUNAT.
      - **id** (string) - Document ID.
      - **code** (string) - SUNAT response code.
      - **description** (string) - Description of the SUNAT response.
      - **notes** (array) - Additional notes about the response.

#### Response Example
```json
{
  "status": 200,
  "success": true,
  "message": "DEMO - El documento fue registrado en el sistema y se encuentra declarado correctamente validado en la sunat!",
  "data": {
    "hash": "AeOqQVd8d5kfPS+CmeCMF+NNMpI=",
    "sunatResponse": {
      "success": true,
      "cdrZip": ">-",
      "cdrResponse": {
        "id": "<string>",
        "code": "<string>",
        "description": "<string>",
        "notes": [
          "<string>"
        ]
      }
    }
  }
}
```
```

--------------------------------

### GET /placa/info/{placa}

Source: https://docs.factiliza.com/api-consulta/endpoint/placa

Retrieves vehicle data based on the provided license plate. Requires Bearer token authentication.

```APIDOC
## GET /placa/info/{placa}

### Description
This endpoint returns detailed information about a vehicle using its license plate.

### Method
GET

### Endpoint
https://api.factiliza.com/v1/placa/info/{placa}

### Parameters
#### Path Parameters
- **placa** (string) - Required - The license plate to query.

#### Query Parameters
None.

#### Request Body
None.

### Request Example
None (GET request with path parameter).

### Response
#### Success Response (200)
- **status** (integer) - The status code of the response.
- **success** (boolean) - Indicates if the request was successful (true) or not (false).
- **message** (string) - A message describing the outcome of the request.
- **data** (object) - Contains detailed vehicle information:
  - **placa** (string) - Vehicle's license plate.
  - **marca** (string) - Vehicle's make.
  - **modelo** (string) - Vehicle's model.
  - **serie** (string) - Vehicle's series number.
  - **color** (string) - Vehicle's color.
  - **motor** (string) - Vehicle's engine number.
  - **vin** (string) - Vehicle's VIN (Vehicle Identification Number).

#### Response Example
```json
{
  "status": 200,
  "message": "Exito",
  "data": {
    "placa": "F3H792",
    "marca": "FIAT",
    "modelo": "FIORINO",
    "serie": "9BD25521A98854312",
    "color": "BLANCO BANCHISA",
    "motor": "8632404",
    "vin": "9BD25521A98854312"
  }
}
```

#### Error Response (400)
- **status** (integer) - The status code of the error.
- **success** (boolean) - Indicates if the request was successful (false).
- **message** (string) - A message describing the error.

#### Error Response Example
```json
{
  "status": 400,
  "success": false,
  "message": "Bad Request"
}
```
```

--------------------------------

### Project Websites Factiliza

Source: https://docs.factiliza.com/api-consulta/endpoint/dni

Retrieves details for the Factiliza project website, including address information and location codes.

```APIDOC
## GET /websites/factiliza

### Description
Retrieves detailed information about the Factiliza project website. This includes address components, RENIEC and SUNAT ubigeo codes, and an array of ubigeo codes.

### Method
GET

### Endpoint
/websites/factiliza

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **direccion** (string) - The primary address information.
- **direccion_completa** (string) - The complete address including region and district.
- **ubigeo_reniec** (string) - The RENIEC ubigeo code.
- **ubigeo_sunat** (string) - The SUNAT ubigeo code.
- **ubigeo** (array of strings) - An array containing ubigeo codes at different levels.
- **fecha_nacimiento** (string) - The date of birth (currently empty).
- **sexo** (string) - The gender (currently empty).

#### Response Example
```json
{
  "direccion": "CASERIO PUÑA",
  "direccion_completa": "CASERIO PUÑA, CAJAMARCA - CHOTA - TACABAMBA",
  "ubigeo_reniec": "060615",
  "ubigeo_sunat": "060417",
  "ubigeo": [
    "06",
    "0604",
    "060417"
  ],
  "fecha_nacimiento": "",
  "sexo": ""
}
```

#### Error Response (400)
- **status** (integer) - The HTTP status code (e.g., 400).
- **success** (boolean) - Indicates if the request was successful (false for errors).
- **message** (string) - A description of the error.

#### Error Response Example
```json
{
  "status": 400,
  "success": false,
  "message": "Bad Request"
}
```
```

--------------------------------

### GET /ruc/info/{ruc}

Source: https://docs.factiliza.com/api-consulta/endpoint/ruc

Retrieves detailed information about a company using its RUC number. Requires Bearer token authentication.

```APIDOC
## GET /ruc/info/{ruc}

### Description
Retrieves detailed information for a given RUC number. This endpoint is secured with Bearer token authentication.

### Method
GET

### Endpoint
https://api.factiliza.com/v1/ruc/info/{ruc}

### Parameters
#### Path Parameters
- **ruc** (integer) - Required - El RUC a consultar

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **status** (integer) - El código de estado de la respuesta
- **success** (boolean) - El estado de la respuesta true o false
- **message** (string) - Mensaje de la respuesta
- **data** (object) - Datos detallados de la respuesta
  - **numero** (string) - Número de identificación (RUC)
  - **nombre_o_razon_social** (string) - Nombre o Razon Social de la empresa
  - **tipo_contribuyente** (string) - Tipo de contribuyente de la empresa
  - **estado** (string) - Estado de la empresa
  - **condicion** (string) - Condición de la empresa
  - **departamento** (string) - Departamento de la empresa
  - **provincia** (string) - Provincia de la empresa
  - **distrito** (string) - Distrito de la empresa
  - **direccion** (string) - Dirección específica
  - **direccion_completa** (string) - Dirección completa, incluyendo distrito, provincia y departamento
  - **ubigeo_sunat** (string) - Ubigeo según SUNAT
  - **ubigeo** (array) - Ubigeo desglosado por componentes (items: string)

#### Response Example
```json
{
  "status": 200,
  "success": true,
  "message": "Exito",
  "data": {
    "numero": "20552103816",
    "nombre_o_razon_social": "AGROLIGHT PERU S.A.C.",
    "tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
    "estado": "SUSPENSION TEMPORAL",
    "condicion": "HABIDO",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SANTA ANITA",
    "direccion": "PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET.",
    "direccion_completa": "PJ. JORGE BASADRE NRO. 158 URB. POP LA UNIVERSAL 2DA ET., LIMA - LIMA - SANTA ANITA",
    "ubigeo_sunat": "150137",
    "ubigeo": [
      "15",
      "1501",
      "150137"
    ]
  }
}
```
```