# Reviso

# Primeros pasos

## Reviso cosas

### Cuestión Autenticación

De momento es sencillo.

Se trata de que hay un **Gran Token** para el **agreement** **1257729** que es el acuerdo de desarrollador

Entrando en ese acuerdo en app.reviso.com, se dio de alta una app para usar el otro acuerdo, el nacional, con numero **125746** que tiene su propio Gran token.

Después hay un publico y un **secret** que es el que se usa de forma global para acompañar al otro token.

### Cuestión endpoints

> Hay un articulo interesante [Use Apis](https://help.reviso.com/en/articles/5573892-use-the-apis) donde se peude obtener una coleccion Postman. (Actualmente de 2023)

Los endpoints son únicos y la forma de buscar es un poco liosa en Postman, aunque parece que mas sencilla para programarlo.

Vien definido en [Filtering](https://api-docs.reviso.com/#filtering)

```json
?filter=name$eq:Joe$and:city$like:*port

```

#### Operadores de filtro

<table id="bkmrk-operator-syntax-equa"><thead><tr><th>Operator</th><th>Syntax</th></tr></thead><tbody><tr><td>Equals</td><td>`$eq:`</td></tr><tr><td>Not equals</td><td>`$ne:`</td></tr><tr><td>Greater than</td><td>`$gt:`</td></tr><tr><td>Greater than or equal</td><td>`$gte:`</td></tr><tr><td>Less than</td><td>`$lt:`</td></tr><tr><td>Less than or equal</td><td>`$lte:`</td></tr><tr><td>Substring match</td><td>`$like:`</td></tr><tr><td>And also</td><td>`$and:`</td></tr><tr><td>Or else</td><td>`$or:`</td></tr><tr><td>In</td><td>`$in:`</td></tr><tr><td>Not In</td><td>`$nin:`</td></tr></tbody></table>

#### Soporte LIKE

Podemos hacer bésquedas de sub strings con `$like`

#### Caracteres especiales y su escape

- "$" is escaped with "$$"
- "(" is escaped with "$("
- ")" is escaped with "$)"
- "*" is escaped with "$*"
- "," is escaped with "$,"
- "\[" is escaped with "$\["
- "\]" is escaped with "$\]"

#### Otras cuestiones

Se puede forzar la bsuqueda de un valor null. con `$null:`

Se pueden usar `in` and `not` como operadores en campos numéricos

```
customerNumber$in:[2,5,7,22,45]

```

#### Escape en URL

Esto es muy especial, por si buscamos que lo dudo por caracteres

- "&lt;" is escaped with "0"
- "&gt;" is escaped with "*1*"
- "\*" is escaped with "*2*"
- "%" is escaped with "*3*"
- ":" is escaped with "*4*"
- "&amp;" is escaped with "*5*"
- "/" is escaped with "*6*"
- "" is escaped with "*7*"
- "\_" is escaped with "*8*"
- " " is escaped with "*9*"
- "?" is escaped with "*10*"
- "." is escaped with "*11*"
- "#" is escaped with "*12*"
- "+" is escaped with "*13*"

Ejemplo de url para obtener el producto ABC 2/3

```json
https://rest.reviso.com/products/ABC_9_2_6_3

```

#### Paginacion

Admite hasta 1000

```json
?pagesize=200

```

# Proceso Clientes

## Crear un cliente

Endpoint: `https://rest.reviso.com/customers`Método: `POST`Body Mínimo:

```json
{
    "address": "Santa clara, 8",
    "city": "Arenys de Mar",
    "corporateIdentificationNumber": "B63637953",
    "country": "España",
    "countryCode": {
        "code": "ES"
    },
    "currency": "EUR",
    "customerGroup": {
        "customerGroupNumber": 1
    },
    "email": "admin@setdart.com",
    "province": {
        "countryCode": {
            "code": "ES"
        },
        "provinceNumber": 8
    },
    "zip": "08359",
    "name": "Setdart online, S.L.",
    "vatNumber": "B63637953",
    "vatZone": {
        "vatZoneNumber": 1
    },
        "paymentTerms": {
        "paymentTermsNumber": 10
    }
}

```

Y se reibe el dato completo si uno hay errores, con un `201`

```json
{
    "address": "Santa clara, 8",
    "balance": 0.00,
    "city": "Arenys de Mar",
    "corporateIdentificationNumber": "B63637953",
    "country": "España",
    "countryCode": {
        "code": "ES"
    },
    "currency": "EUR",
    "customerGroup": {
        "customerGroupNumber": 1
    },
    "email": "admin@setdart.com",
    "province": {
        "countryCode": {
            "code": "ES"
        },
        "provinceNumber": 8
    },
    "zip": "08359",
    "name": "Setdart online, S.L.",
    "vatNumber": "B63637953",
    "vatZone": {
        "vatZoneNumber": 1
    },
        "paymentTerms": {
        "paymentTermsNumber": 10
    }
}

```

### Sobre los campos especificos

Campos que deben ir

#### CustomeerGroup

`https://rest.reviso.com/customer-groups`

<table id="bkmrk-n%C3%BAmero-descripcion-1"><thead><tr><th align="left">Número</th><th align="left">Descripcion</th></tr></thead><tbody><tr><td align="left">1</td><td align="left">Clientes nacionales</td></tr><tr><td align="left">2</td><td align="left">Clientes EU</td></tr><tr><td align="left">3</td><td align="left">Cliente con retenciones. NO se usa</td></tr><tr><td align="left">4</td><td align="left">Clientes moneda extranjera. No se usa</td></tr><tr><td align="left">5</td><td align="left">Clientes fuera EU</td></tr></tbody></table>

#### VatZone

`https://rest.reviso.com/vat-zones`

Plantea serias dudas pednientes de consulta.

<table id="bkmrk-n%C3%BAmero-descripci%C3%B3n-1"><thead><tr><th align="left">Número</th><th align="left">Descripción</th></tr></thead><tbody><tr><td align="left">1</td><td align="left">Domestic</td></tr><tr><td align="left">2</td><td align="left">VAT Zone</td></tr><tr><td align="left">3</td><td align="left">Outside EU</td></tr><tr><td align="left">4</td><td align="left">Domestic Exento</td></tr><tr><td align="left">7</td><td align="left">España Recergo de Equivalencia</td></tr></tbody></table>

#### Payment Terms

Dedidido por el 10 creod por mi.