---
agentTools:
  projectIndex: https://docs.grafeno.digital/llms.txt
---

# Capturar títulos

este recurso permite a captura de títulos.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "API V2 Grafeno",
    "version": "3.0.0"
  },
  "servers": [
    {
      "url": "https://pagamentos.grafeno.be/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Account-Number",
        "in": "header"
      },
      "sec1": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": ""
      }
    }
  },
  "security": [
    {
      "sec0": [],
      "sec1": []
    }
  ],
  "paths": {
    "/concessions/assignors/{assignor_id}/catching": {
      "post": {
        "summary": "Capturar títulos",
        "description": "este recurso permite a captura de títulos.",
        "operationId": "capture-charges",
        "parameters": [
          {
            "name": "assignor_id",
            "in": "path",
            "description": "Id do cedente",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "charges"
                ],
                "properties": {
                  "charges": {
                    "type": "array",
                    "description": "uuids das cobranças que serão capturadas / cedidas.",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "charges": [
                      "37ea12ca-c9ea-40f3-9166-4a866e7fff00",
                      "f29221d1-5263-40bd-81f9-3c63426dab63",
                      "ce76ffd1-3193-4138-aefb-e2cbf7406822"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"data\": {\n    \"id\": \"d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23\",\n    \"type\": \"concession\",\n    \"attributes\": {\n      \"createdAt\": \"2021-01-01T00:00:00.000-03:00\",\n      \"updatedAt\": \"2021-01-01T00:00:00.000-03:00\",\n      \"status\": \"pending\",\n      \"type\": \"offering\",\n      \"fromAccount\": {\n        \"data\": {\n          \"id\": 5000,\n          \"type\": \"account\",\n          \"attributes\": {\n            \"agency\": \"0001\",\n            \"accountNumber\": \"00001111-4\",\n            \"documentNumber\": \"26146719000129\"\n          }\n        }\n      },\n      \"toAccount\": {\n        \"data\": {\n          \"id\": 5000,\n          \"type\": \"account\",\n          \"attributes\": {\n            \"agency\": \"0001\",\n            \"accountNumber\": \"00001112-2\",\n            \"documentNumber\": \"27214814000185\"\n          }\n        }\n      },\n      \"access\": {\n        \"data\": {\n          \"id\": \"d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23\",\n          \"type\": \"access\",\n          \"attributes\": {\n            \"createdAt\": \"2021-01-01T00:00:00.000-03:00\",\n            \"updatedAt\": \"2021-01-01T00:00:00.000-03:00\",\n            \"expiresAt\": \"2021-01-01T00:00:00.000-03:00\",\n            \"status\": \"active\",\n            \"agreeType\": \"manual\"\n          }\n        }\n      },\n      \"charges\": {\n        \"data\": [\n          {\n            \"id\": \"d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23\",\n            \"type\": \"charge\",\n            \"attributes\": {\n              \"clientControlNumber\": \"001-2\",\n              \"receiptNumber\": \"51080701212344000127550010000000981364117781\",\n              \"status\": \"pending\",\n              \"value\": \"20.0\",\n              \"dueDate\": \"2021-01-01T00:00:00.000-03:00\",\n              \"transferState\": \"transferred\",\n              \"payer\": {\n                \"data\": {\n                  \"type\": \"payer\",\n                  \"attributes\": {\n                    \"name\": \"Grafeno Digital\",\n                    \"documentNumber\": \"05944596991300\",\n                    \"email\": \"your_email@grafeno.digital\"\n                  }\n                }\n              }\n            }\n          }\n        ]\n      }\n    }\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23"
                        },
                        "type": {
                          "type": "string",
                          "example": "concession"
                        },
                        "attributes": {
                          "type": "object",
                          "properties": {
                            "createdAt": {
                              "type": "string",
                              "example": "2021-01-01T00:00:00.000-03:00"
                            },
                            "updatedAt": {
                              "type": "string",
                              "example": "2021-01-01T00:00:00.000-03:00"
                            },
                            "status": {
                              "type": "string",
                              "example": "pending"
                            },
                            "type": {
                              "type": "string",
                              "example": "offering"
                            },
                            "fromAccount": {
                              "type": "object",
                              "properties": {
                                "data": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "integer",
                                      "example": 5000,
                                      "default": 0
                                    },
                                    "type": {
                                      "type": "string",
                                      "example": "account"
                                    },
                                    "attributes": {
                                      "type": "object",
                                      "properties": {
                                        "agency": {
                                          "type": "string",
                                          "example": "0001"
                                        },
                                        "accountNumber": {
                                          "type": "string",
                                          "example": "00001111-4"
                                        },
                                        "documentNumber": {
                                          "type": "string",
                                          "example": "26146719000129"
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "toAccount": {
                              "type": "object",
                              "properties": {
                                "data": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "integer",
                                      "example": 5000,
                                      "default": 0
                                    },
                                    "type": {
                                      "type": "string",
                                      "example": "account"
                                    },
                                    "attributes": {
                                      "type": "object",
                                      "properties": {
                                        "agency": {
                                          "type": "string",
                                          "example": "0001"
                                        },
                                        "accountNumber": {
                                          "type": "string",
                                          "example": "00001112-2"
                                        },
                                        "documentNumber": {
                                          "type": "string",
                                          "example": "27214814000185"
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "access": {
                              "type": "object",
                              "properties": {
                                "data": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "example": "d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23"
                                    },
                                    "type": {
                                      "type": "string",
                                      "example": "access"
                                    },
                                    "attributes": {
                                      "type": "object",
                                      "properties": {
                                        "createdAt": {
                                          "type": "string",
                                          "example": "2021-01-01T00:00:00.000-03:00"
                                        },
                                        "updatedAt": {
                                          "type": "string",
                                          "example": "2021-01-01T00:00:00.000-03:00"
                                        },
                                        "expiresAt": {
                                          "type": "string",
                                          "example": "2021-01-01T00:00:00.000-03:00"
                                        },
                                        "status": {
                                          "type": "string",
                                          "example": "active"
                                        },
                                        "agreeType": {
                                          "type": "string",
                                          "example": "manual"
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "charges": {
                              "type": "object",
                              "properties": {
                                "data": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "example": "d8d74d12-88db-4b51-a6ca-6ac7bdd6cc23"
                                      },
                                      "type": {
                                        "type": "string",
                                        "example": "charge"
                                      },
                                      "attributes": {
                                        "type": "object",
                                        "properties": {
                                          "clientControlNumber": {
                                            "type": "string",
                                            "example": "001-2"
                                          },
                                          "receiptNumber": {
                                            "type": "string",
                                            "example": "51080701212344000127550010000000981364117781"
                                          },
                                          "status": {
                                            "type": "string",
                                            "example": "pending"
                                          },
                                          "value": {
                                            "type": "string",
                                            "example": "20.0"
                                          },
                                          "dueDate": {
                                            "type": "string",
                                            "example": "2021-01-01T00:00:00.000-03:00"
                                          },
                                          "transferState": {
                                            "type": "string",
                                            "example": "transferred"
                                          },
                                          "payer": {
                                            "type": "object",
                                            "properties": {
                                              "data": {
                                                "type": "object",
                                                "properties": {
                                                  "type": {
                                                    "type": "string",
                                                    "example": "payer"
                                                  },
                                                  "attributes": {
                                                    "type": "object",
                                                    "properties": {
                                                      "name": {
                                                        "type": "string",
                                                        "example": "Grafeno Digital"
                                                      },
                                                      "documentNumber": {
                                                        "type": "string",
                                                        "example": "05944596991300"
                                                      },
                                                      "email": {
                                                        "type": "string",
                                                        "example": "your_email@grafeno.digital"
                                                      }
                                                    }
                                                  }
                                                }
                                              }
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    \"Você precisa entrar ou registrar-se antes de continuar.\"\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "example": "Você precisa entrar ou registrar-se antes de continuar."
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "422",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"field\": \"field_test\",\n      \"details\": [\n        \"blank\"\n      ],\n      \"messages\": [\n        \"não pode ficar em branco\"\n      ]\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string",
                            "example": "field_test"
                          },
                          "details": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "example": "blank"
                            }
                          },
                          "messages": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "example": "não pode ficar em branco"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "64d50ab7b21b9e0063a215f9:64daa061ca8a4b0019e3c73b"
}
```