{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","params":[],"results":{"codes":[]}},"next":{"description":"","pages":[]},"title":"Playground: Carnês","type":"basic","slug":"playground-carnes","excerpt":"Você está em: *\"Ambiente de Testes > Playground: Carnês\"*","body":"Para acessar o ambiente de testes você precisa de uma conta Gerencianet. <a href=\"https://gerencianet.com.br/#abrirconta\" title=\"Cadastro ao nosso sistema, seja nosso cliente\" target=\"_blank\">Crie sua conta</a>.\n\nO Playground (também chamado de \"sandbox\") é um ambiente de homologação/testes no qual o integrador, independente da operação a ser realizada, pode utilizar para conhecer o mecanismo e o fluxo de pagamento em um ambiente 100% de teste e descomplicado. [Conheça mais](https://dev.gerencianet.com.br/docs/playground) sobre o Playground oferecido pela Gerencianet.\n\nUm carnê é um conjunto de transações (parcelas) geradas em lote e com forma de pagamento já definida. As parcelas de um carnê vencem mensalmente, de acordo com a data definida pelo integrador. Para mais detalhes sobre carnês, <a href=\"https://dev.gerencianet.com.br/docs/carnes-introducao\" target=\"_blank\">confira a seção específica</a>.\n\n[Para gerar um carnê](https://dev.gerencianet.com.br/docs/playground-carnes#carnet), você precisa informar os seguintes dados:\n\n- Itens (ou serviço) oferecido;\n- Data de vencimento da 1ª parcela;\n- Número de parcelas (repetições).\n\nA seguir, confira todos os endpoints presentes em nosso Playground, dentro da modalidade de \"Carnês\":\n\n<ul><li><div class=\"\"><span class=\"post\">POST</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet\">/v1/carnet</a> <em>(cria um carnê)</em></div></li><li><div class=\"\"><span class=\"get\">GET</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id\">/v1/carnet/:id</a> <em>(retorna informações de carnê existente)</em></div></li><li><div class=\"\"><span class=\"put\">PUT</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_metadata\">/v1/carnet/:id/metadata</a> <em>(incluir \"notification_url\" e \"custom_id\" em um carnê existente)</em></div></li><li><div class=\"\"><span class=\"put\">PUT</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_parcel_parcel\">/v1/carnet/:id/parcel/:parcel</a> <em>(alterar data de vencimento de parcela específica de um carnê)</em></div></li><li><div class=\"\"><span class=\"put\">PUT</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_cancel\">/v1/carnet/:id/cancel</a> <em>(cancela um determinado carnê)</em></div></li><li><div class=\"\"><span class=\"put\">PUT</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_parcel_parcel_cancel\">/v1/carnet/:id/parcel/:parcel/cancel</a> <em>(cancelamento de parcela específica de um carnê existente)</em></div></li><li><div class=\"\"><span class=\"post\">POST</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_resend\">/v1/carnet/:id/resend</a> <em>(reenvio por email um carnê)</em></div></li><li><div class=\"\"><span class=\"post\">POST</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_parcel_parcel_resend\">/v1/carnet/:id/parcel/:parcel/resend</a> <em>(reenviar por email determinada parcela de um carnê)</em></div></li><li><div class=\"\"><span class=\"post\">POST</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#carnet_id_history\">/v1/carnet/:id/history</a> <em>(acrescentar descrição ao histórico de um carnê)</em></div></li><li><div class=\"\"><span class=\"put\">PUT</span> <a href=\"https://dev.gerencianet.com.br/docs/playground-carnes#settlecarnetparcel\">/v1/carnet/:id/parcel/:parcel/settle</a> <em>(marcar como pago [baixa manual] uma determinada parcela de carnê)</em></div></li></ul>\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet\"><span class=\"post\">POST</span></a><strong class=\"text-endpoint\">/v1/carnet</strong></div>\n\nUtilizado para geração de um conjunto de transações (parcelas) geradas em lote e com uma forma de pagamento já definida. As parcelas de um carnê vencem mensalmente, de acordo com a data definida pelo integrador.\n\nUm carnê possui o status <code>active</code> (ativo) até o vencimento da última parcela.\n\nOs principais atributos da geração de um carnê são:\n\n- <code>Item</code>: item que está sendo vendido;\n- <code>Customer</code>: dados pessoais do pagador;\n- <code>Expire_at</code>: vencimento da primeira parcela do carnê; e\n- <code>Repeats</code>: número de parcelas do carnê.\n\nAinda cabe frisar que cada carnê gerado possui uma identificação única denominada <code>carnet_id</code>, e cada parcela desse carnê também possuem um identificador único denominado <code>charge_id</code>.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>POST /v1/carnet</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/9bb647c-post-carnet.png\",\n \"post-carnet.png\",\n 1385,\n 367,\n \"#eeefef\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para criar um carnê no Playground. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"items\\\": [\\n {\\n \\\"name\\\": \\\"Meu Produto\\\",\\n \\\"value\\\": 7500,\\n \\\"amount\\\": 1\\n }\\n ],\\n \\\"customer\\\": {\\n \\\"name\\\": \\\"Gorbadoc Oldbuck\\\",\\n \\\"cpf\\\": \\\"94271564656\\\",\\n \\\"phone_number\\\": \\\"5144916523\\\"\\n },\\n \\\"expire_at\\\": \\\"2018-12-20\\\",\\n \\\"configurations\\\": {\\n \\\"fine\\\": 200,\\n \\\"interest\\\": 33\\n },\\n \\\"message\\\": \\\"Este é um espaço de até 80 caracteres para informar algo a seu cliente\\\",\\n \\\"repeats\\\": 5,\\n \\\"split_items\\\": false\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200, // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n \\\"data\\\": {\\n \\\"carnet_id\\\": 12345, // identificador único do carnê\\n \\\"status\\\": \\\"up_to_date\\\", // carnê encontra-se em dia, não há nenhuma parcela inadimplente. Assim que o carnê é criado, ele também recebe este status up_to_date. O termo \\\"up_to_date\\\" equivale a \\\"em dia\\\"\\n \\\"cover\\\": \\\"link_https_capa_do_carne\\\", // link da capa do carnê\\n \\\"link\\\": \\\"link_https_do_carne\\\", // link do carnê, de acordo com as repetições\\n \\\"pdf\\\": {\\n \\\"carnet\\\": \\\"link_https_do_pdf_do_carne\\\", // link do PDF do carnê, de acordo com as repetições\\n \\\"cover\\\": \\\"link_https_do_pdf_da_capa_do_carne\\\" // link do PDF da capa do carnê\\n },\\n \\\"charges\\\": [\\n {\\n \\\"charge_id\\\": 511813, // número identificador da primeira parcela do carnê\\n \\\"parcel\\\": \\\"1\\\", // número da parcela do carnê\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"value\\\": 7500, // valor, em centavos, da primeira parcela do carnê (7500 equivale a R$ 75,00)\\n \\\"expire_at\\\": \\\"2018-12-20\\\", // data de vencimento da parcela do carnê no seguinte formato: 2018-12-20 (equivale a 20/12/2018)\\n \\\"url\\\": \\\"link_https_da_primeira_lamina\\\", // link da primeira parcela (lâmina) do carnê\\n \\\"pdf\\\": {\\n \\\"charge\\\": \\\"link_https_da_primeira_lamina\\\" // link do PDF da primeira parcela (lâmina) do carnê\\n },\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\" // linha digitável da primeira parcela (lâmina) do carnê\\n },\\n {\\n \\\"charge_id\\\": 511814, // número identificador da segunda parcela do carnê\\n \\\"parcel\\\": \\\"2\\\", // número da parcela do carnê\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"value\\\": 7500, // valor, em centavos, da segunda parcela do carnê (7500 equivale a R$ 75,00)\\n \\\"expire_at\\\": \\\"2019-01-20\\\", // data de vencimento da parcela do carnê no seguinte formato: 2019-01-20 (equivale a 20/01/2019)\\n \\\"url\\\": \\\"link_https_da_segunda_lamina\\\", // link da segunda parcela (lâmina) do carnê\\n \\\"pdf\\\": {\\n \\\"charge\\\": \\\"link_https_da_segunda_lamina\\\" // link do PDF da segunda parcela (lâmina) do carnê\\n },\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\" // linha digitável da segunda parcela (lâmina) do carnê\\n },\\n {\\n \\\"charge_id\\\": 511815, // número identificador da terceira parcela do carnê\\n \\\"parcel\\\": \\\"3\\\", // número da parcela do carnê\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"value\\\": 7500, // valor, em centavos, da terceira parcela do carnê (7500 equivale a R$ 75,00)\\n \\\"expire_at\\\": \\\"2019-02-20\\\", // data de vencimento da parcela do carnê no seguinte formato: 2019-02-20 (equivale a 20/02/2019)\\n \\\"url\\\": \\\"link_https_da_terceira_lamina\\\", // link da terceira parcela (lâmina) do carnê\\n \\\"pdf\\\": {\\n \\\"charge\\\": \\\"link_https_da_terceira_lamina\\\" // link do PDF da terceira parcela (lâmina) do carnê\\n },\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\" // linha digitável da terceira parcela (lâmina) do carnê\\n },\\n {\\n \\\"charge_id\\\": 511816, // número identificador da quarta parcela do carnê\\n \\\"parcel\\\": \\\"4\\\", // número da parcela do carnê\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"value\\\": 7500, // valor, em centavos, da quarta parcela do carnê (7500 equivale a R$ 75,00)\\n \\\"expire_at\\\": \\\"2019-03-20\\\", // data de vencimento da parcela do carnê no seguinte formato: 2019-03-20 (equivale a 20/03/2019)\\n \\\"url\\\": \\\"link_https_da_quarta_lamina\\\", // link da quarta parcela (lâmina) do carnê\\n \\\"pdf\\\": {\\n \\\"charge\\\": \\\"link_https_da_quarta_lamina\\\" // link do PDF da quarta parcela (lâmina) do carnê\\n },\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\" // linha digitável da quarta parcela (lâmina) do carnê\\n },\\n {\\n \\\"charge_id\\\": 511817, // número identificador da quinta parcela do carnê\\n \\\"parcel\\\": \\\"5\\\", // número da parcela do carnê\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"value\\\": 7500, // valor, em centavos, da quinta parcela do carnê (7500 equivale a R$ 75,00)\\n \\\"expire_at\\\": \\\"2019-04-20\\\", // data de vencimento da parcela do carnê no seguinte formato: 2019-04-20 (equivale a 20/04/2019)\\n \\\"url\\\": \\\"link_https_da_quinta_lamina\\\", // link da quinta parcela (lâmina) do carnê\\n \\\"pdf\\\": {\\n \\\"charge\\\": \\\"link_https_da_quinta_lamina\\\" // link do PDF da quinta parcela (lâmina) do carnê\\n },\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\" // linha digitável da quinta parcela (lâmina) do carnê\\n }\\n ]\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"id\\\": \\\"/Carnet\\\",\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"items\\\": {\\n \\\"type\\\": \\\"array\\\",\\n \\\"minItems\\\": 1,\\n \\\"items\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"name\\\": {\\n \\\"type\\\": \\\"string\\\"\\n },\\n \\\"value\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 0\\n },\\n \\\"amount\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 1,\\n \\\"exclusiveMinimum\\\": false\\n }\\n },\\n \\\"required\\\": [\\n \\\"name\\\",\\n \\\"value\\\"\\n ]\\n }\\n },\\n \\\"customer\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/BasicCustomer\\\",\\n \\\"properties\\\": {\\n \\\"name\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 1,\\n \\\"maxLength\\\": 255,\\n \\\"pattern\\\": \\\"^[ ]*(.+[ ]+)+.+[ ]*$\\\"\\n },\\n \\\"cpf\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 11,\\n \\\"maxLength\\\": 11\\n },\\n \\\"email\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"maxLength\\\": 255,\\n \\\"pattern\\\": \\\"^[A-Za-z0-9_\\\\\\\\-]+(?:[.][A-Za-z0-9_\\\\\\\\-]+)*:::at:::[A-Za-z0-9_]+(?:[-.][A-Za-z0-9_]+)*\\\\\\\\.[A-Za-z0-9_]+$\\\"\\n },\\n \\\"phone_number\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"pattern\\\": \\\"^[1-9]{2}9?[0-9]{8}$\\\"\\n },\\n \\\"birth\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"pattern\\\": \\\"^[12][0-9]{3}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$\\\"\\n },\\n \\\"address\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/AddressOptional\\\",\\n \\\"properties\\\": {\\n \\\"street\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 0,\\n \\\"maxLength\\\": 200\\n },\\n \\\"number\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\",\\n \\\"integer\\\"\\n ],\\n \\\"minLength\\\": 0,\\n \\\"maxLength\\\": 55\\n },\\n \\\"neighborhood\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 0,\\n \\\"maxLength\\\": 255\\n },\\n \\\"zipcode\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"pattern\\\": \\\"^[0-9]{8}$\\\"\\n },\\n \\\"city\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 0,\\n \\\"maxLength\\\": 50\\n },\\n \\\"complement\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 0,\\n \\\"maxLength\\\": 45\\n },\\n \\\"state\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"pattern\\\": \\\"^(?:A[CLPM]|BA|CE|DF|ES|GO|M[ATSG]|P[RBAEI]|R[JNSOR]|S[CEP]|TO)$\\\"\\n }\\n }\\n },\\n \\\"juridical_person\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/JuridicalPerson\\\",\\n \\\"properties\\\": {\\n \\\"corporate_name\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 1,\\n \\\"maxLength\\\": 255\\n },\\n \\\"cnpj\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"minLength\\\": 14,\\n \\\"maxLength\\\": 14\\n }\\n },\\n \\\"required\\\": [\\n \\\"corporate_name\\\",\\n \\\"cnpj\\\"\\n ]\\n }\\n },\\n \\\"required\\\": [\\n \\\"phone_number\\\"\\n ]\\n },\\n \\\"expire_at\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"pattern\\\": \\\"^[12][0-9]{3}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$\\\"\\n },\\n \\\"repeats\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 1,\\n \\\"maximum\\\": 12,\\n \\\"exclusiveMinimum\\\": false,\\n \\\"exclusiveMaximum\\\": false\\n },\\n \\\"split_items\\\": {\\n \\\"type\\\": \\\"boolean\\\"\\n },\\n \\\"metadata\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"custom_id\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ]\\n },\\n \\\"notification_url\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"pattern\\\": \\\"^https?://.+\\\"\\n }\\n }\\n },\\n \\\"instructions\\\": {\\n \\\"type\\\": \\\"array\\\",\\n \\\"minItems\\\": 1,\\n \\\"maxItems\\\": 4,\\n \\\"items\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"minLength\\\": 1,\\n \\\"maxLength\\\": 90\\n }\\n },\\n \\\"configurations\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/Configurations\\\",\\n \\\"minProperties\\\": 1,\\n \\\"properties\\\": {\\n \\\"fine\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 0,\\n \\\"maximum\\\": 1000\\n },\\n \\\"interest\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 0,\\n \\\"maximum\\\": 330\\n }\\n }\\n },\\n \\\"message\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"pattern\\\": \\\"^[^\\\\n]{0,100}(\\\\n[^\\\\n]{0,100}){0,3}$\\\"\\n },\\n \\\"discount\\\": {\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/Discount\\\",\\n \\\"properties\\\": {\\n \\\"type\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"enum\\\": [\\n \\\"percentage\\\",\\n \\\"currency\\\"\\n ]\\n },\\n \\\"value\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 1\\n }\\n },\\n \\\"required\\\": [\\n \\\"type\\\",\\n \\\"value\\\"\\n ]\\n },\\n \\\"conditional_discount\\\": {\\n \\\"id\\\": \\\"/ConditionalDiscount\\\",\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"type\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"enum\\\": [\\n \\\"percentage\\\",\\n \\\"currency\\\"\\n ]\\n },\\n \\\"value\\\": {\\n \\\"type\\\": \\\"integer\\\",\\n \\\"minimum\\\": 1\\n },\\n \\\"until_date\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"pattern\\\": \\\"^[12][0-9]{3}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$\\\"\\n }\\n },\\n \\\"required\\\": [\\n \\\"type\\\",\\n \\\"value\\\",\\n \\\"until_date\\\"\\n ]\\n }\\n },\\n \\\"required\\\": [\\n \\\"items\\\",\\n \\\"customer\\\",\\n \\\"expire_at\\\",\\n \\\"repeats\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON cria um carnê, em que o nome do produto/serviço é \"Meu Produto\", valor R$ 75,00 e quantidade 1, com os dados do comprador, a data de vencimento da primeira parcela em 20/12/2018 e contendo 5 parcelas (em meses). Ou seja, é um carnê contendo 5 parcelas de R$ 75,00, perfazendo um valor total de R$ 375,00, com a primeira parcela de R$ 75,00 vencendo em 20/12/2018, a segunda em 20/01/2019, e assim sucessivamente. Além disso, estamos usando uma mensagem de até 80 caracteres para informar algo ao cliente, e se a lâmina for paga após o vencimento, será cobrado 2% de multa e 0,033% de juros por dia.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id\"><span class=\"get\">GET</span></a><strong class=\"text-endpoint\">/v1/carnet/:id</strong></div>\n\nRetorna informações sobre um carnê criado. Cada transação criada via carnê possui uma única chave identificadora que a identifica.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>GET /v1/carnet/:id</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/Hl63OTvXTKOpx94PDqhn_c00f0b34a29744c9bb1e09b9918c62d2.png\",\n \"c00f0b34a29744c9bb1e09b9918c62d2.png\",\n \"1430\",\n \"123\",\n \"#11aac2\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para retornar informações sobre um carnê criado em Playground. Além disso, é possível observar a saída prevista disponível para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> do carnê desejado:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Parâmetro de entrada: informe o \\\"carnet_id\\\" do carnê criado\",\n \"language\": \"text\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200, // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n \\\"data\\\": {\\n \\\"carnet_id\\\": 14196, // número da ID referente ao carnê\\n \\\"status\\\": \\\"active\\\", // carnê ativo\\n \\\"repeats\\\": 3, // número de parcelas do carnê\\n \\\"cover\\\": \\\"https://visualizacaosandbox.gerencianet.com.br/emissao/93084_624_DOCOR0/A4CC-93084-134363-CHOCA3\\\", // link HTTP da capa do carnê\\n \\\"value\\\": 22500, // valor, em centavos, por exemplo: 22500 equivale a R$ 225,00\\n \\\"custom_id\\\": null, // identificador próprio opcional\\n \\\"notification_url\\\": null, // link URL de notificação\\n \\\"split_items\\\": false, // dividir itens entre as parcelas (Boolean). Define se os itens do carnê serão divididos entre as parcelas (true), ou se o valor de cada parcela será o valor total dos itens (false)\\n \\\"charges\\\": [\\n {\\n \\\"charge_id\\\": 184208, // número da ID referente à transação gerada\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"url\\\": \\\"https://visualizacaosandbox.gerencianet.com.br/emissao/93084_624_DOCOR0/A4CL-93084-134363-CHOCA3/93084-134363-CHOCA3\\\", // link HTTP da primeira parcela do carnê\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\", // código de barras do boleto da primeira parcela\\n \\\"parcel\\\": 1, // número da parcela do carnê\\n \\\"expire_at\\\": \\\"2017-08-20\\\", // data de vencimento da primeira parcela do carnê\\n \\\"configurations\\\": {\\n \\\"interest\\\": 33, // valor cobrado de juros por dia após a data de vencimento\\n \\\"fine\\\": 200 // valor cobrado de multa após o vencimento\\n }\\n },\\n {\\n \\\"charge_id\\\": 184209, // número da ID referente à transação gerada\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"url\\\": \\\"https://visualizacaosandbox.gerencianet.com.br/emissao/93084_624_DOCOR0/A4CL-93084-134363-CHOCA3/93084-134364-XICOR1\\\", // link HTTP da segunda parcela do carnê\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\", // código de barras do boleto da segunda parcela\\n \\\"parcel\\\": 2, // número da parcela do carnê\\n \\\"expire_at\\\": \\\"2017-09-20\\\", // data de vencimento da segunda parcela do carnê\\n \\\"configurations\\\": {\\n \\\"interest\\\": 33, // valor cobrado de juros por dia após a data de vencimento\\n \\\"fine\\\": 200 // valor cobrado de multa após o vencimento\\n }\\n },\\n {\\n \\\"charge_id\\\": 184210, // número da ID referente à transação gerada\\n \\\"status\\\": \\\"waiting\\\", // forma de pagamento selecionada, aguardando a confirmação do pagamento\\n \\\"url\\\": \\\"https://visualizacaosandbox.gerencianet.com.br/emissao/93084_624_DOCOR0/A4CL-93084-134363-CHOCA3/93084-134365-HIDA8\\\", // link HTTP da terceira parcela do carnê\\n \\\"barcode\\\": \\\"00000.00000 00000.000000 00000.000000 0 00000000000000\\\", // código de barras do boleto da terceira parcela\\n \\\"parcel\\\": 3, // número da parcela do carnê\\n \\\"expire_at\\\": \\\"2017-10-20\\\", // data de vencimento da terceira parcela do carnê\\n \\\"configurations\\\": {\\n \\\"interest\\\": 33, // valor cobrado de juros por dia após a data de vencimento\\n \\\"fine\\\": 200 // valor cobrado de multa após o vencimento\\n }\\n }\\n ],\\n \\\"created_at\\\": \\\"2017-02-08 09:21:36\\\",\\n \\\"history\\\": [ // propriedades abaixo com todo o histórico deste carnê\\n {\\n \\\"message\\\": \\\"Carnê ativo\\\",\\n \\\"created_at\\\": \\\"2017-02-08 09:21:36\\\"\\n }\\n ]\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n }\n ]\n}\n[/block]\nEsse JSON retorna informações de um carnê criado em Playground, conforme pode ser observado na aba \"Dados de Saída\".\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_metadata\"><span class=\"put\">PUT</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/metadata</strong></div>\n\nPermite incluir em um carnê informações como <code>notification_url</code> e <code>custom_id</code>. Para isso, você precisa informar o <code>carnet_id</code> do carnê existente no qual deseja incluir essas informações. Este endpoint é de **extrema importância** para atualizar sua URL de notificação atrelada ao carnê ou modificar o <code>custom_id</code> previamente associado aos carnês.\n\n- <code>notification_url</code>: é um endereço de sua URL válida que receberá as notificações de mudanças de status das transações. As confirmações, falhas ou qualquer tipo de alteração de status serão informadas à URL fornecida na geração do carnê;\n\n- <code>custom_id</code>: permite associar uma transação Gerencianet a uma ID específica de seu sistema ou aplicação, permitindo identificá-la caso você possua uma identificação específica e queira mantê-la.\n\n**Casos de uso deste endpoint:**\n\n- Integrador alterou o IP do servidor que estava associado na URL de notificação dos carnês;\n\n- Integrador atualizou a URL de notificação para os novos carnês que forem criadas, mas precisa atualizar também nos carnês anteriores que foram gerados e que estão associadas com a URL incorreta/desatualizada;\n\n- Foi instalado SSL (https) no servidor do cliente e mesmo que o cliente defina uma regra de redirecionamento 301 ou 302, será preciso definir a nova URL nos carnês que estão com a URL \"antiga\";\n\n- Integrador gerou cobranças e não havia informado a URL de notificação ao enviar a requisição de criação do carnê;\n\n- Modificar ou acrescentar uma informação junto ao atributo <code>custom_id</code> associado aos carnês gerados previamente;\n\n- Dentre outros possíveis cenários.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>PUT /v1/carnet/:id/metadata</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/cJX9QumlTcOniH2o5ip7_fe22d560346c4efd88e469e4c9935f4c.png\",\n \"fe22d560346c4efd88e469e4c9935f4c.png\",\n \"1417\",\n \"398\",\n \"#d69131\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para alterar a URL de notificação e o custom_id de um carnê já existente no Playground. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> do carnê desejado:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"notification_url\\\": \\\"htttp://www.meusite.com.br/notificacoes/\\\",\\n \\\"custom_id\\\": \\\"258789877\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"type\\\": \\\"object\\\",\\n \\\"minProperties\\\": 1,\\n \\\"id\\\": \\\"/CarnetMetadataUpdate\\\",\\n \\\"properties\\\": {\\n \\\"notification_url\\\": {\\n \\\"type\\\": [\\n \\\"string\\\",\\n \\\"null\\\"\\n ],\\n \\\"pattern\\\": \\\"^https?://.+\\\",\\n \\\"minLength\\\": \\\"1\\\",\\n \\\"maxLength\\\": \\\"255\\\"\\n },\\n \\\"custom_id\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"minLength\\\": \\\"1\\\",\\n \\\"maxLength\\\": \\\"255\\\",\\n \\\"pattern\\\": \\\"^[a-zA-Z0-9\\\\\\\\_\\\\\\\\-\\\\\\\\s]+$\\\"\\n }\\n }\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON permite alterar a URL de notificação e o custom_id de um determinado carnê.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_parcel_parcel\"><span class=\"put\">PUT</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/parcel/:parcel</strong></div>\n\nPossibilita alterar a data de vencimento de uma determinada parcela de um carnê. Para tal, é necessário que você informe o <code>carnet_id</code>, a parcela que deseja e a <code>expire_at</code> (nova data de vencimento, no formato <code>YYYY-MM-DD</code>).\n\nSomente parcelas que estejam com status <code>waiting</code> (aguardando) ou <code>unpaid</code> (não pago) podem ter suas datas de vencimento alteradas.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>PUT /v1/carnet/:id/parcel/:parcel</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/d6S3qHYuTMi6kWbemNet_0562b15bc885466b845f6200b0c9a366.png\",\n \"0562b15bc885466b845f6200b0c9a366.png\",\n \"1434\",\n \"429\",\n \"#da902e\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que permite alterar a data de vencimento de uma determinada parcela de um carnê. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método. Lembrando que você deve informar o <code>carnet_id</code> e o número da parcela que deseja alterar o vencimento.\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"expire_at\\\": \\\"2018-12-30\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"id\\\": \\\"/CarnetParcelUpdate\\\",\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"expire_at\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"pattern\\\": \\\"^[12][0-9]{3}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$\\\"\\n }\\n },\\n \\\"required\\\": [\\n \\\"expire_at\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON realiza a alteração da data de vencimento de um boleto no Playground, alterando para a data 30/12/2018 o vencimento de uma determinada parcela de um carnê.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_cancel\"><span class=\"put\">PUT</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/cancel</strong></div>\n\nPossibilita efetuar o cancelamento de um determinado carnê. Para isso, você deve informar o <code>carnet_id</code> que deseja efetuar o cancelamento.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>PUT /v1/carnet/:id/cancel</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/NUukOsrvToyK31q9V2kb_c819c30ed6e7467fa1078a02e6fac929.png\",\n \"c819c30ed6e7467fa1078a02e6fac929.png\",\n \"1434\",\n \"123\",\n \"#f7871d\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para cancelar um determinado carnê. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Parâmetro de entrada: informe a \\\"carnet_id\\\" do carnê desejado\",\n \"language\": \"text\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n }\n ]\n}\n[/block]\nEsse JSON efetua o cancelamento de um determinado carnê criado em Playground.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_parcel_parcel_cancel\"><span class=\"put\">PUT</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/parcel/:parcel/cancel</strong></div>\n\nPossibilita efetuar o cancelamento de uma parcela específica de um carnê existente. Para isso, você deve informar o <code>carnet_id</code> e o número da parcela que deseja efetuar o cancelamento.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>PUT /v1/carnet/:id/parcel/:parcel/cancel</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/2OMtigeRTVintr7cvFxC_8ef61b22e245413eb3045c54ed4a4cd9.png\",\n \"8ef61b22e245413eb3045c54ed4a4cd9.png\",\n \"1432\",\n \"153\",\n \"#f28824\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para cancelar uma parcela específica de um carnê existente. Além disso, é possível observar a saída prevista disponível para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> e o número da parcela do carnê:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Parâmetro de entrada: informe o \\\"carnet_id\\\" e o \\\"número da parcela\\\" do carnê\",\n \"language\": \"text\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n }\n ]\n}\n[/block]\nEsse JSON permite cancelar uma parcela específica de um carnê existente e que foi criado em Playground.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_resend\"><span class=\"post\">POST</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/resend</strong></div>\n\nEste método possibilita que o carnê seja reenviado para um endereço de email. É preciso que você informe o <code>carnet_id</code> do carnê desejado.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>POST /v1/carnet/:id/resend</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/045lJwItRD6KBpKUjuAA_092014167a084e37b7552fc3716028c3.png\",\n \"092014167a084e37b7552fc3716028c3.png\",\n \"1416\",\n \"394\",\n \"#4e875b\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para reenviar por email um determinado carnê criado em Playground. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> do carnê desejado:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"email\\\": \\\"[email protected]\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"id\\\": \\\"/CarnetResend\\\",\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"email\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"maxLength\\\": 255,\\n \\\"pattern\\\": \\\"^[A-Za-z0-9_\\\\\\\\-]+(?:[.][A-Za-z0-9_\\\\\\\\-]+)*@[A-Za-z0-9_]+(?:[-.][A-Za-z0-9_]+)*\\\\\\\\.[A-Za-z0-9_]+$\\\"\\n }\\n },\\n \\\"required\\\": [\\n \\\"email\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON define que o endereço \"[email protected]\" receberá uma segunda via de um determinado carnê que foi criado em Playground.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_parcel_parcel_resend\"><span class=\"post\">POST</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/parcel/:parcel/resend</strong></div>\n\nEste método possibilita que uma determinada parcela de um carnê seja reenviado para um endereço de e-mail. Para tal, você deve informar o <code>carnet_id</code> desejado.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>POST /v1/carnet/:id/parcel/:parcel/resend</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/5VH9L8voTIOu5oUEseCR_2ab8612babbc4db4ae7e226171cb3792.png\",\n \"2ab8612babbc4db4ae7e226171cb3792.png\",\n \"1416\",\n \"427\",\n \"#ca8639\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para reenviar por email um determinado carnê criado em Playground. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> e o número da parcela que você deseja reenviar:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"email\\\": \\\"[email protected]\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"id\\\": \\\"/CarnetParcelResend\\\",\\n \\\"type\\\": \\\"object\\\",\\n \\\"properties\\\": {\\n \\\"email\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"maxLength\\\": 255,\\n \\\"pattern\\\": \\\"^[A-Za-z0-9_\\\\\\\\-]+(?:[.][A-Za-z0-9_\\\\\\\\-]+)*@[A-Za-z0-9_]+(?:[-.][A-Za-z0-9_]+)*\\\\\\\\.[A-Za-z0-9_]+$\\\"\\n }\\n },\\n \\\"required\\\": [\\n \\\"email\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON define que o endereço \"[email protected]\" receberá uma segunda via de uma determinada parcela de um carnê que foi criado em Playground.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"carnet_id_history\"><span class=\"post\">POST</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/history</strong></div>\n\nO histórico de um carnê é semelhante ao histórico de uma transação. Porém, ele reflete as ações que o carnê em si sofreu. E, da mesma forma, é possível adicionar mensagens personalizadas ao histórico de um carnê, sem que estas, contudo, influenciem no fluxo do mesmo.\n\nPara tal, você deve informar o <code>carnet_id</code> do carnê desejado. Essa descrição deve possuir no mínimo um caractere e no máximo 255 caracteres.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>POST /v1/carnet/:id/history</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/Hctr9AK2TdqJLZEdANTc_34debf18f3fb44e1a9852eec51d7a6f6.png\",\n \"34debf18f3fb44e1a9852eec51d7a6f6.png\",\n \"1434\",\n \"397\",\n \"#4f8761\",\n \"\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para acrescentar uma descrição a um determinado carnê no Playground. Além disso, é possível observar a saída prevista e o schema de validação com todas as tags (obrigatórias e opcionais) disponíveis para este método. Lembrando que também é preciso informar o parâmetro de entrada <code>carnet_id</code> do carnê desejado:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"description\\\": \\\"Camisa Polo tamanho G cor azul\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200 // retorno HTTP \\\"200\\\" informando que o pedido foi bem sucedido\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n },\n {\n \"code\": \"{\\n \\\"type\\\": \\\"object\\\",\\n \\\"id\\\": \\\"/CarnetHistory\\\",\\n \\\"properties\\\": {\\n \\\"description\\\": {\\n \\\"type\\\": \\\"string\\\",\\n \\\"maxLength\\\": \\\"255\\\",\\n \\\"minLength\\\": \\\"1\\\"\\n }\\n },\\n \\\"required\\\": [\\n \\\"description\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Schema\"\n }\n ]\n}\n[/block]\nEsse JSON acrescenta a descrição \"Camisa Polo tamanho G cor azul\" em um determinado carnê que foi criado no Playground.\n\n<br>\n<hr>\n\n<div class=\"distancia_top\"><a name=\"settlecarnetparcel\"><span class=\"put\">PUT</span></a><strong class=\"text-endpoint\">/v1/carnet/:id/parcel/:parcel/settle</strong></div>\n\nPermite marcar como pago (baixa manual) uma determinada parcela de um carnê. Para tal, você deverá informar o <code>carnet_id</code> e o número da parcela do carnê que deseja marcar como pago.\n\nOu seja, se você possui um carnê de 12 parcelas cujo <code>carnet_id</code> seja <code>24744</code> e você deseja marcar a 2ª parcela como \"paga\", deverá passar o <code>carnet_id</code> e o número <code>2</code>.\n\nNa imagem a seguir, é possível observar a tela de nosso ambiente de testes no qual constam os recursos atrelados ao método <code>PUT /v1/carnet/:id/parcel/:parcel/settle</code> que estão disponíveis para utilização:\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/581a53b-settleCarnetParcel.png\",\n \"settleCarnetParcel.png\",\n 1387,\n 176,\n \"#f0f1f0\"\n ]\n }\n ]\n}\n[/block]\nA seguir, um JSON simples que pode ser utilizado para marcar como pago uma determinada parcela de um carnê criado em Playground. Além disso, é possível observar a saída prevista disponível para este método. Lembrando que você deve informar o <code>carnet_id</code> e o número da parcela que deseja marcar como pago:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Parâmetro de entrada: informe o \\\"carnet_id\\\" e o número da parcela do carnê que deseja marcar como pago\",\n \"language\": \"text\",\n \"name\": \"Dados de Entrada\"\n },\n {\n \"code\": \"{\\n \\\"code\\\": 200\\n}\",\n \"language\": \"json\",\n \"name\": \"Dados de Saída\"\n }\n ]\n}\n[/block]","updates":[],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57866f040413ad0e009e6253","project":"575aeffae12cf20e002f306c","version":{"version":"1","version_clean":"1.0.0","codename":"2016","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478","5a7c4127490e52002a7f643c","5ce43ecb9e6a78002aae5c66","5ce7de70923530005cbe627a","5f9c614b7352f400665cd7f6"],"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":34},"user":"57601a13af3e090e00108059","__v":15,"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Ambiente de Testes","slug":"ambiente-de-testes","order":4,"from_sync":false,"reference":true,"_id":"57866e72b2f4060e00fa39ca","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","createdAt":"2016-07-13T16:38:10.846Z","__v":0},"githubsync":"","parentDoc":null,"createdAt":"2016-07-13T16:40:36.834Z"}
Playground: Carnês
Você está em: *"Ambiente de Testes > Playground: Carnês"*