# Obtener novedades de un envío

## Obtener novedades

<mark style="color:green;">`POST`</mark> `https://api.rocketfy.co/api/public/shippings/news`

Este endpoint te permite retornar las novedades de un envío.

#### Headers

| Name          | Type   | Description                                                                                                                                                               |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | string | <p>Token que recibes del método de autenticación inicial en Primeros pasos y debe enviarse en el siguiente formato: <br><br><code>Bearer MI\_TOKEN\_DE\_ACCESO</code></p> |

#### Request Body

| Name         | Type   | Description                                                                                                                                                                                                                                                      |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| status       | string | <p>Estado de las novedades, que pueden ser uno de los siguientes:<br><br>- <strong>pending</strong>: Novedad pendiente por solucionar<br>- <strong>solved</strong>: Novedad solucionada y gestionada</p>                                                         |
| customerID   | string | <p>Identificador de la tienda que se retorna al crear una tienda en Rocketfy y que debe de estar almacenado en tu base de datos. <br><br><strong>Ejemplo:</strong> <code>testpublicapi\_1325176081</code></p>                                                    |
| shipping\_id | string | <p>Identificador de la orden que se desea consultar, naturalmente es tiene una estructura hexadecimal que corresponde a un <strong>ObjectID</strong> de <strong>MongoDB</strong> <br><br><strong>Ejemplo:</strong> <br><code>60da23857c26053a3cec72db</code></p> |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```javascript
{
   "results": [
        {
            "_id" : "5f5931b6128a372cb0e48151",
            "shipping_id" : "5f57a222b01f6c2d581439a6",
            "courrier" : "servientrega",
            "status" : "solved", //Vease en las tablas inferiores
            "created_date" : 2021-06-28T14:31:17+05:00, //Fecha en ISO 8601
            "type" : "pickup",
            "description" : "Paquete no alistado previamente",
            "note" : "Porque no había una bolsa en donde empacarlo"
            "key" : "order_not_ready",
            "evidence": {
                "required": true,
                "file": "https://fs.rocketfy"
            },
            "solution": { //Esta propiedad aparece cuando se soluciona la novedad
                "type": "text",
                "response": "Ya compramos bolsa, pueden pasar por él",
                "response_date": 2021-06-28T14:31:17+05:00, //Fecha en ISO 8601
            },
            "answers" : null //En el caso de que la novedad contenga preguntas
        }
    ]
}
```

{% endtab %}

{% tab title="404 Hubo un error al momento." %}

```
{ "message": "No encontramos novedades para este envío"}
```

{% endtab %}
{% endtabs %}

### Estados de las novedades de un envío

| Estado de la novedad | Descripción                                                                                                      |
| :------------------: | ---------------------------------------------------------------------------------------------------------------- |
|       `pending`      | Esta propiedad hace referencia a que la novedad del envío aún no ha sido solucionada o gestionada por la tienda. |
|       `solved`       | Esta propiedad hace referencia a que la novedad del envío fue solucionada por la tienda o por la transportadora  |

### Tipos de novedades de un envío

|    Tipo    | Descripción                                                                            |
| :--------: | -------------------------------------------------------------------------------------- |
|  `pickup`  | Esta propiedad hace referencia a que la novedad se presentó fue durante la recolección |
| `delivery` | Esta propiedad hace referencia a que la novedad se presentó durante la entrega         |
