README

可用服务

• 会计 示例：$ramp->accounting->...
• 会计连接 示例：$ramp->accountingconnections->...
• 账单 示例：$ramp->bills->...
• 业务 示例：$ramp->business->...
• 卡片计划 - 此功能未实现，您应使用 支出计划
• 卡片 示例：$ramp->cards->...
• 现金返还 示例：$ramp->cashbacks->...
• 部门 示例：$ramp->departments->...
• 实体 示例：$ramp->entities->...
• 潜在客户 示例：$ramp->leads->...
• 账簿账户 示例：$ramp->ledgeraccounts->...
• 限制 示例：$ramp->limits->...
• 位置 示例：$ramp->locations->...
• 备忘录 示例：$ramp->memos->...
• 商家 示例：$ramp->merchants->...
• 收据集成 示例：$ramp->receiptintegrations->...
• 收据 示例：$ramp->receipts->...
• 报销 示例：$ramp->reimbursements->...
• 支出计划 示例：$ramp->spendprograms->...
• 报表 示例：$ramp->statements->...
• 交易 示例：$ramp->transactions->...
• 转账 示例：$ramp->transfers->...
• 用户 示例：$ramp->users->...
• 供应商 示例：$ramp->vendors->...

发布 ramp 配置

命令

php artisan vendor:publish --tag=rampapi-config

published config/ramp.php

<?php

return [
    'client_id' => env('RAMP_CLIENT_ID', 'your_client_id'),
    'client_secret' => env('RAMP_CLIENT_SECRET', 'your_client_secret'),
    'prod_ready' => env('PROD_READY', false),
    'scopes' => env('RAMP_SCOPES', 'accounting:read accounting:write bills:read business:read cards:read cards:write cashbacks:read departments:read departments:write entities:read leads:read leads:write limits:read limits:write locations:read locations:write memos:read merchants:read receipt_integrations:read receipt_integrations:write receipts:read reimbursements:read spend_programs:read spend_programs:write statements:read transactions:read transfers:read users:read users:write'),
];

示例

获取用户列表

use R0aringthunder\RampApi\Ramp;

public function rampUsers()
{
  $ramp = new Ramp();
  $users = $ramp->users->listUsers();
  return response()->json($users);
}

获取所有卡片

use R0aringthunder\RampApi\Ramp;

public function fetchCards()
{
    $ramp = new Ramp();
    $cards = $ramp->cards->listCards();
    return response()->json($cards['data']);
}

获取单个卡片

use R0aringthunder\RampApi\Ramp;

public function fetchCard()
{
  $ramp = new Ramp();
  $card = $ramp->cards->fetchCard('[CARD ID]');
  return response()->json($card);
}

重要

实施时，API和Ramp仪表板大约需要5分钟同步，但API对更改立即做出反应。

重要

Ramp只接受以下文件类型：png, webp, heif, pdf, heic, jpg, jpeg

将收据上传到交易

use R0aringthunder\RampApi\Ramp;
use Illuminate\Http\Request;

public function uploadReceipt(Request $request)
{
  $ramp = new Ramp();

  $file = $request->file('receipts');
  $path = $file->getRealPath();

  return $ramp->receipts->upload(
      [
          'user_id' => $request->input('ramp_user_id'),
          'transaction_id' => $request->input('ramp_transaction_id'),
      ],
      $path
  );
}

提示

在$path处，您可以使用上传的文件或文件的链接（例如，S3链接）。

更多示例即将到来...