openapi: 3.1.1
info:
  title: Receipt
  version: 2.0.0
  description: Schema for Receipt in Beckn Logistics domain.
  license:
    name: CC-BY-NC-SA 4.0 International
  contact:
    name: Beckn Labs
    url: https://beckn.io
components:
  schemas:
    LogisticsReceipt:
      x-iri: https://schema.nfh.global/LogisticsReceipt/v2.0
      type: object
      title: Receipt
      description: Digital acknowledgment of payment and delivery for a logistics service.
      required:
      - id
      - shipmentId
      - fare
      properties:
        id:
          type: string
          example: RCP-2024-001234
        shipmentId:
          type: string
          example: SHP-2024-001234
        invoiceNumber:
          type: string
          example: INV-2024-9900
        issuedAt:
          type: string
          format: date-time
        fare:
          $ref: https://schema.nfh.global/Fare/v2.0/attributes.yaml#/components/schemas/Fare
        paymentMode:
          type: string
          enum:
          - PREPAID
          - COD
          - TO_PAY
          - CREDIT
          example: PREPAID
        paymentTransactionId:
          type: string
          example: TXN-UPI-2024-123456
        paidAt:
          type: string
          format: date-time
        shipper:
          $ref: https://schema.nfh.global/Contact/v2.0/attributes.yaml#/components/schemas/Contact
        consignee:
          $ref: https://schema.nfh.global/Contact/v2.0/attributes.yaml#/components/schemas/Contact
        carrier:
          $ref: https://schema.nfh.global/Carrier/v2.0/attributes.yaml#/components/schemas/Carrier
        deliveryProof:
          $ref: https://schema.nfh.global/Proof/v2.0/attributes.yaml#/components/schemas/Proof
        downloadUrl:
          type: string
          format: uri
          description: URL to download PDF receipt