/**
     * Obtiene listado de pedidos.
     * @OA\Get (
     *     path="/api/pedidos",
     *     tags={"Pedidos"},
     *     security={{"bearerAuth":{}}},
     *     @OA\Response(
     *         response=200,
     *         description="success",
     *         @OA\JsonContent(
     *                     @OA\Property(
     *                         property="success",
     *                         type="boolean",
     *                     ),
     *                     @OA\Property(
     *                     type="object",
     *                     property="data",

     *                         @OA\Property(
     *                             property="current_page",
     *                             type="number",
     *                         ),
     *                         @OA\Property(
     *                         type="array",
     *                         property="data",
     *                            @OA\Items(
     *                               type="object",
     *                                @OA\Property(
     *                                    property="id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="created_at",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="updated_at",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="deleted_at",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="metodo_pago",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="key_pago",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_total",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="distribuidor_id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="vendedor_id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="tienda_id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="creado_por",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="estatus",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="estatus_pago",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="estatus_envio",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="tipo_envio",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="observacion",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="vale",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="cupon",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="direccion_cliente",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="total_cajas",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="aceptar_terminos",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_cupon",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_vale",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_paqueteria",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_descuento_cliente",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="monto_neto",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="tipoCupon",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="porcentjeCuponAplicado",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="montoCuponAplicado",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="mercadopago_id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="referencia_mercadopago",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="external_folio",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="external_transaccion_id",
     *                                    type="number",
     *                                ),
     *                                @OA\Property(
     *                                    property="external_estatus",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="total_asociado",
     *                                    type="number",
     *                                ),
     *                            )
     *                         ),
     *                         @OA\Property(
     *                             property="first_page_url",
     *                             type="string",
     *                         ),
     *                         @OA\Property(
     *                             property="from",
     *                             type="number",
     *                         ),
     *                         @OA\Property(
     *                             property="last_page",
     *                             type="number",
     *                         ),
     *                         @OA\Property(
     *                             property="last_page_url",
     *                             type="string",
     *                         ),
     *                         @OA\Property(
     *                            type="array",
     *                            property="links",
     *                            @OA\Items(
     *                                type="object",
     *                                @OA\Property(
     *                                    property="url",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="label",
     *                                    type="string",
     *                                ),
     *                                @OA\Property(
     *                                    property="active",
     *                                    type="boolean",
     *                                ),
     *                             ),
     *                         ),
     *                         @OA\Property(
     *                             property="next_page_url",
     *                             type="string",
     *                         ),
     *                         @OA\Property(
     *                             property="path",
     *                             type="string",
     *                         ),
     *                         @OA\Property(
     *                             property="per_page",
     *                             type="number",
     *                         ),
     *                         @OA\Property(
     *                             property="pre_page_url",
     *                             type="string",
     *                         ),
     *                         @OA\Property(
     *                             property="to",
     *                             type="number",
     *                         ),
     *                         @OA\Property(
     *                             property="total",
     *                             type="number",
     *                         )
     *                     )
     *                  )
     *             )
     *         )
     * )
     */