###############
Shipment Detail
###############

Detalle de embarque
*******************

Obtiene información de un embarque en base al ID enviado.

.. include:: /peticion.rst

Resource URL
============

.. http:get:: HOST/v1/shipments/(int:folio)/

	:param folio: Folio del embarque.
	:type folio: int

	:reqheader Authorization: Token del usuario.
	:reqheader Content-Type: Define el formato en el que se envian los datos por el body.

	:>json int folio: Folio del embarque.
	:>json string reference_document: Tipo de documento referenciado.
	:>json int reference_folio: Folio del documento referenciado.
	:>json string reference_serie: Serie del documento referenciado.
	:>json obj status: Estatus del documento.
	:>json string created_at: Fecha de creación del documento.
	:>json obj user: Usuario que creó el documento.
	:>json obj warehouse: Almacén asociado.
	:>json string payment_method: Documento de pago.
	:>json string account: Cuenta bancaria.
	:>json string account_name: Nombre de la cuenta bancaria.
	:>json string expiration_date: Fecha de expiración.
	:>json string authorization_code: Código de autorización.
	:>json obj user_authorization: Usuario que autorizó el documento.
	:>json string authorization_date: Fecha de autorización.
	:>json obj bank: Banco asociado.
	:>json obj deliveries: Entregas asociadas al documento.


	:statuscode 200: Ningún error.
	:statuscode 400: Algún parámetro es incorrecto.
	:statuscode 401: Token no válido o no enviado.
	:statuscode 404: El embarque no existe.

	**status object**:

	:>json int id: Id del estado.
	:>json string description: Descripción del estado.

	**user object**:

	:>json int id: Id del usuario.
	:>json string username: Nombre de usuario.

	**warehouse object**:

	:>json int id: Id del almacén.
	:>json string name: Nombre del almacén.

	**user_authorization object**:

	:>json int id: Id de usuario.
	:>json string username: Nombre de usuario.

	**bank object**:

	:>json int id: Id del banco.
	:>json string description: Nombre del banco.

	**deliveries object**:

	:>json int id: Id de la entrega.
	:>json int delivery_batch: Folio de lote.
	:>json obj status: Objeto con estatus de la entrga.
	:>json string municipality: Ciudad.
	:>json string state: Estado.
	:>json string country: País.

	**status object**:

	:>json int id: Id del estado.
	:>json string description: Descripción del estado.

Example request
===============

.. sourcecode:: http

	GET /v1/shipments/3671055/ HTTP/1.1
	Host: api.next-cloud.mx
	Accept: application/json
	Content-Type: application/json
	Authorization: Token ( token del usuario )

Example Response
================

.. sourcecode:: http

	HTTP/1.1 200 OK
	Vary: Accept
	Content-Type: application/json
	Allow: GET

.. literalinclude:: example_shipments_by_id_01.json
	:language: json