Facturas (v3)

GET

/v3/company/$:companyUid/invoice/supplierId/:supplierId

GET

/v3/company/$:companyUid/invoice/supplierId/:supplierId

curl https://api.megaport.com/v3/company/$companyUid/invoice/supplierId/supplierId

200Retrieved

{
  "data": {
    "$id": 1,
    "batchId": 1,
    "invoices": [
      {
        "$id": 2,
        "currencyCode": "AUD",
        "dueDate": "2023-12-01T12:00:00",
        "invoiceAmount": 2420,
        "invoiceDate": "2023-11-01T12:00:00",
        "invoiceId": "AUS00012345",
        "openBalance": 0
      },
      {
        "$id": 3,
        "currencyCode": "AUD",
        "dueDate": "2023-12-31T12:00:00",
        "invoiceAmount": 2420,
        "invoiceDate": "2023-12-01T12:00:00",
        "invoiceId": "AUS00012346",
        "openBalance": 0
      },
      {
        "$id": 4,
        "currencyCode": "AUD",
        "dueDate": "2024-02-01T12:00:00",
        "invoiceAmount": 2420,
        "invoiceDate": "2024-01-02T12:00:00",
        "invoiceId": "AUS00012347",
        "openBalance": 0
      }
    ]
  },
  "message": "Lista de facturas para el cliente [1]",
  "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy"
}

Devuelve una lista de todas las facturas para la combinación de empresa y mercado de facturación, para el rango de fechas especificado.

Puede encontrar el companyUid y supplierId en los siguientes endpoints de Megaport:

companyUid se devuelve en el endpoint de lista de productos GET /v2/products o en el endpoint de claves API GET /v2/auth/apikeys.
supplierId es el “firstPartyId” devuelto en el endpoint de mercados de facturación GET /v2/market para el proveedor relevante.

Nota: Se devuelve un error 401 si el usuario no tiene permisos de Finanzas en la empresa especificada. Para obtener más información, consulte Administración de roles de usuario.

Parámetros de ruta

companyUidstringRequerido

supplierIdstringRequerido

Parámetros de consulta

fromDatestringOpcional

La fecha de inicio para la cual se deben devolver todas las facturas para la combinación de empresa / mercado de facturación. Introduzca la fecha en el formato: aaaa-mm-dd. (Opcional)

toDatestringOpcional

La fecha de finalización para devolver todas las facturas de la combinación de empresa / mercado de facturación. Introduzca la fecha en el formato: aaaa-mm-dd. (Opcional).

Respuesta

Facturas (v3) / Facturas (v3)

dataobjectOpcional

messagestringOpcional

termsstringOpcional