From 0b5ed42a2f02b45733d1a04f2b97f486f6e0d358 Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Thu, 21 Dec 2023 13:54:55 -0300 Subject: [PATCH 1/9] 1 --- .../reconciliation-reports.en.md | 25 +++--- .../reconciliation-reports.es.md | 31 +++---- .../reconciliation-reports.pt.md | 27 +++---- .../reports/released-money/how-to-use.pt.md | 81 +++++-------------- .../reports/released-money/introduction.pt.md | 74 ++++++++--------- 5 files changed, 88 insertions(+), 150 deletions(-) diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md index db97aaf5e5..f2204a6af4 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md @@ -1,20 +1,19 @@ # Reports -Mercado Pago reports are sets of financial information that help you visualize your account data (available balance, transactions, liquidity), allowing you to combine sales and other operations with your internal management systems. +The reports from Mercado Pago provide financial information to track the movements of your account, such as available balance, transactions, and liquidity. This facilitates the reconciliation of sales and other operations with your internal management systems. + +> WARNING +> +> The Available Balance report was disabled on March 1, 2022 +> +> You can use the [Released Money Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile the transactions that affect the balance available in your account, including your bank withdrawals. Check the table below for more details on the available report types. | Report type | Description | |---|---| -| Releases report| Informs how the balance available in your account is composed, detailing all amounts involved in a period of time. For more information [click here](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/released-money/introduction). | -| Account balance report| Informs the transactions/movements that affected your account balance. For more information [click here](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/account-money/introduction). | -| Available balance report| Informs the liquidity of your business, showing the amount available for use in the account. [Click here](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/available-money/introduction) for more information.

* **This report will be deprecated soon**. We recommend using the [Released Report](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile the transactions that compose the balance available in your account, including your bank withdrawals. | - -> NOTE -> -> > WARNING -> -> The Available Balance report will be disabled from March 1st, 2022 -> -> You can use the [Releases report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile the transactions that affect the balance available in your account, including your bank withdrawals. - +| Released Money Report | Provides the composition of the available balance in your account, with details about the values involved in a specific period. Read the [Released Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) for more information. | +| Account Money Report | Informs about transactions/movements that have affected your account balance. For more information, read the [Account Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/account-money/introduction). | +| Available Money Report | Presents the liquidity of your business, detailing the available amount in the account for use. For more information, read the [Available Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/available-money/introduction). +

* **This report is no longer available**. Use the [Released Money Report](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile transactions that constitute the available balance in your account, including bank withdrawals. | +| Mercado Pago’s split payment solution sales report | The Mercado Pago’s split payment solution sales report offers a comprehensive overview of transactions from linked sellers, available for download in _csv_ and js_on formats. To learn more, read the [documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md index ac54ee013b..ede457bd45 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md @@ -1,31 +1,20 @@ # Reportes -Los reportes de Mercado Pago son conjuntos de información financiera que te ayudan a visualizar los movimientos de tu cuenta (saldo disponible, transacciones, liquidez), permitiéndote combinar ventas y otras operaciones con tus sistemas de gestión interna. - -Consulta la tabla a continuación para obtener más detalles sobre los tipos de reportes disponibles. - - - -* ----[mlm, mlb, mlc, mco, mlu, mpe]---- Reportes de conciliación ------------ ----[mla, mlm]---- Movimientos generales ------------ - ----[mla]---- - + [Liquidaciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) - ------------ - ----[mlm, mlb, mlc, mco, mlu, mpe]---- - + [Liberaciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) - ------------ - + [Todas las transacciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/account-money/introduction) - + [Dinero retirado](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/available-money/introduction) +Los reportes de Mercado Pago proporcionan información financiera para dar seguimiento a las transacciones de su cuenta, como el saldo disponible, las transacciones y la liquidez. Esto facilita la conciliación de las ventas y otras operaciones con sus sistemas de gestión internos. > NOTE > -> El reporte de Dinero retirado será deshabilitado desde el 1 de marzo de 2022 +> El reporte de Dinero Disponible fue deshabilitado el 1 de marzo de 2022 > -> Puedes usar el [reporte de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones del dinero disponible en tu cuenta, incluidos tus retiros bancarios. +> Puedes usar el [reporte de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para realizar la conciliación de las transacciones que afecten el saldo disponible en su cuenta, incluyendo sus retiros bancarios. +Consulta la tabla a continuación para obtener más detalles sobre los tipos de reportes disponibles. | Tipo de reporte | Descripción | |---|---| -| ----[mlm, mlb, mlc, mco, mlu, mpe]---- Reporte de liberaciones ------------ ----[mla]---- Reporte de Liquidaciones ------------ | Informa cómo está compuesto el saldo disponible en tu cuenta, detallando todos los montos involucrados en un período de tiempo. Para más información, [haz clic aquí](https://www.mercadopago.com.br/developers/es/guides/additional-content/reports/released-money/introduction).| -| Reporte de todas las transacciones| Informa las transacciones/movimientos que afectaron el saldo de tu cuenta. Para más información, [haz clic aquí](https://www.mercadopago.com.br/developers/es/guides/additional-content/reports/account-money/introduction).| -| Reporte de dinero retirado| Informa la liquidez de tu negocio, detallando el monto disponible para ser usado en la cuenta. [Haz clic aquí](https://www.mercadopago.com.br/developers/es/guides/additional-content/reports/available-money/introduction) para más información.

* **Próximamente este reporte será deshabilitado**. Recomendamos utilizar el ----[mlm, mlb, mlc, mco, mlu, mpe]---- [Reporte de Liberaciones](https://www.mercadopago.com.br/developers/es/guides/additional-content/reports/available-money/introduction) ------------ ----[mla]---- [Reporte de Liquidaciones](https://www.mercadopago.com.ar/developers/es/guides/additional-content/reports/available-money/introduction) ------------ para conciliar las transacciones que conforman el saldo disponible en tu cuenta, incluidos los retiros bancarios.| -| Reportes de facturación| El equipo de **Marketplace de Mercado Libre** ha desarrollado una serie de reportes de facturación para proporcionar los detalles financieros de las transacciones realizadas en Mercado Pago a partir de las ventas en Mercado Libre.

Los datos de los reportes también incluyen información financiera de los usuarios que no venden a través de Mercado Libre, ya que los datos de facturación son de Mercado Pago. Para más información, [haz clic aquí](https://developers.mercadolibre.com.ar/es_ar/reportes-de-facturacion).| +| ----[mlm, mlb, mlc, mco, mlu, mpe]---- Reporte de Liberaciones ------------ ----[mla]---- Reporte de Liquidaciones ------------ | Proporciona la composición del saldo disponible en su cuenta, con detalles sobre los valores involucrados en un período determinado. Consulte la [documentación de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para obtener más información. | +| Reporte de Dinero en cuenta | Informa sobre las transacciones/movimientos que afectaron su saldo en cuenta. Para obtener más información, consulte la [documentación de Dinero en cuenta](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/account-money/introduction). | +| Reporte de Dinero disponible | Presenta la liquidez de su negocio, detallando el valor disponible en cuenta para su uso. Para obtener más información, consulte la [documentación de Dinero disponible](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/available-money/introduction). +

* **Este reporte ya no está disponible**. Utilice el [Reporte de Liberaciones](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones que componen el saldo disponible en su cuenta, incluyendo los retiros bancarios. | +| Reportes de Facturación | El **Marketplace de Mercado Libre** ha desarrollado una serie de reportes de facturación para proporcionar detalles financieros de las transacciones realizadas en Mercado Pago a partir de las ventas en Mercado Libre.

Los datos de los reportes también incluyen información financiera de usuarios que no realizan ventas en Mercado Libre, ya que los datos de facturación son de Mercado Pago. Para obtener más información, consulte la [documentación](https://developers.mercadolibre.com.ar/es_ar/reportes-de-facturacion).| +| Reporte de Ventas de la Solución Split de Pagos do Mercado Pago | El Reporte de ventas de la solución split de pagos do Mercado Pago ofrece una visión completa de las transacciones de los vendedores vinculados, disponible para su descarga en los formatos _csv_ y _json_. Para obtener más información, consulte la [documentación](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md index 76b83afd1d..d981a13ead 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md @@ -1,29 +1,20 @@ # Relatórios -Os relatórios do Mercado Pago são conjuntos de informações financeiras que ajudam a visualizar as movimentações da sua conta (saldo disponível, transações, liquidez), permitindo conciliar vendas e outras operações com seus sistemas de gestão internos. - -Confira a tabela abaixo para mais detalhes sobre os tipos de relatório disponíveis. - -* Movimentações gerais - ----[mla]---- - + [Liquidaçoes](/developers/pt/guides/additional-content/reports/released-money/introduction) - ------------ - ----[mlm, mlb, mlc, mco, mlu, mpe]---- - + [Liberações](/developers/pt/guides/additional-content/reports/released-money/introduction) - ------------ - + [Dinheiro em conta](/developers/pt/guides/additional-content/reports/account-money/introduction) - + [Dinheiro disponível](/developers/pt/guides/additional-content/reports/available-money/introduction) +Os relatórios do Mercado Pago fornecem informações financeiras para acompanhar as movimentações da sua conta, como saldo disponível, transações e liquidez. Isso facilita a conciliação das vendas e outras operações com seus sistemas de gestão internos. > NOTE > -> A partir do dia 1º de março de 2022, o relatório Dinheiro disponível será desabilitado +> O relatório Dinheiro Disponível foi desabilitado em 1º de março de 2022 > > Você pode usar o [relatório de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------](/developers/pt/guides/additional-content/reports/released-money/introduction) para fazer a reconciliação das transações que afetem o saldo disponível na sua conta, incluindo seus saques bancários. +Confira a tabela abaixo para mais detalhes sobre os tipos de relatório disponíveis. | Tipo de relatório | Descrição | |---|---| -| Relatório Liberações | Informa como o saldo disponível em sua conta está composto, detalhando todos os valores envolvidos em um período de tempo. Para mais informações, [clique aqui](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction). | -| Relatório Dinheiro em conta | Informa as transações/movimentações que afetaram seu saldo em conta. Para mais informações, [clique aqui](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/account-money/introduction). | -| Relatório Dinheiro disponível | Informa a liquidez do seu negócio, discriminando o valor disponível em conta para uso. [Clique aqui](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/available-money/introduction) para mais informações.

* **Este relatório será descontinuado em breve**. Recomendamos o uso do [Relatório Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para realizar a reconciliação das transações que compõem o saldo disponível na sua conta, incluindo seus saques bancários.| -| Relatórios de faturamento | A **equipe de Marketplace do Mercado Livre** desenvolveu uma série de relatórios de faturamento, para disponibilizar os detalhes financeiros das transações realizadas no Mercado Pago a partir das vendas no Mercado Livre.

Os dados dos relatórios também contemplam informações financeiras de usuários que não realizam vendas pelo Mercado Livre, uma vez que os dados de faturamento são do Mercado Pago. Para mais informações, [clique aqui](https://developers.mercadolivre.com.br/pt_br/relatorios-de-faturamento#Resumen).| +| Relatório Liberações | Informa a composição do saldo disponível na sua conta, com detalhes sobre os valores envolvidos em um determinado período. Leia a [documentação de Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para mais informações. | +| Relatório Dinheiro em conta | Informa as transações/movimentações que afetaram seu saldo em conta. Para mais informações, leia a [documentação de Dinheiro em conta](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/account-money/introduction). | +| Relatório Dinheiro disponível | Apresenta a liquidez do seu negócio, detalhando o valor disponível em conta para uso. Para obter mais informações, leia a [documentação de Dinheiro disponível](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/available-money/introduction). +

* **Este relatório não está mais disponível**. Utilize o [Relatório de Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para conciliar as transações que compõem o saldo disponível em sua conta, incluindo saques bancários. | +| Relatórios de faturamento | A **equipe de Marketplace do Mercado Livre** desenvolveu uma série de relatórios de faturamento, para disponibilizar os detalhes financeiros das transações realizadas no Mercado Pago a partir das vendas no Mercado Livre.

Os dados dos relatórios também contemplam informações financeiras de usuários que não realizam vendas pelo Mercado Livre, uma vez que os dados de faturamento são do Mercado Pago. Para mais informações, acesse a [documentação](https://developers.mercadolivre.com.br/pt_br/relatorios-de-faturamento#Resumen).| +| Relatório de vendas da solução split de pagamentos do Mercado Pago | O relatório de vendas da solução split de pagamentos do Mercado Pago oferece um panorama completo das transações de vendedores vinculados, disponível para download nos formatos csv e json. Para saber mais, leia a [documentação](https://www.mercadopago.com.br/developers/pt/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/how-to-use.pt.md b/guides/additional-content/reports/released-money/how-to-use.pt.md index 784a031178..41e6b41256 100644 --- a/guides/additional-content/reports/released-money/how-to-use.pt.md +++ b/guides/additional-content/reports/released-money/how-to-use.pt.md @@ -1,89 +1,52 @@ -# Como usar o relatório? +# Usos do relatório Quando o relatório estiver pronto e baixado, você terá um arquivo pronto para consultar as planilhas de cálculo e importá-las para o programa que você usa. -Para consultar o relatório, recomendamos baixá-lo em formato .csv para poder abri-lo no programa que possa visualizá-lo. O arquivo deve estar configurado em formato UTF-8 para evitar problemas de leitura. +Para consultar o relatório, recomendamos baixá-lo em formato _csv_ para poder abri-lo no programa que possa visualizá-lo. O arquivo deve estar configurado em formato UTF-8 para evitar problemas de leitura. -## O que contém no relatório? +## Conteúdo do relatório -O relatório é composto por: - -| Composição do relatório | Descrição | +| Campo do relatório | Descrição | | --- | --- | -| Initial Available Balance |
Saldo inicial.

| -| Release |
O detalhe das ----[mla]---- liquidaçoes ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberações ------------ de dinheiro que inclui o saldo inicial.

| -| Block |
Os bloqueios de dinheiro por disputas.

| -| Unblock |
Os desbloqueios após a resolução das disputas.

| -| Subtotal |
É a soma das transações que compõem cada seção.

| -| Total|
É o resultado final composto pela soma de todos os subtotais.

Ou seja:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = resultado total

| +| Initial Available Balance |
Saldo inicial. Indica o valor que estava disponível na data inicial do período que você selecionou para fazer a reconciliação.

| +| Release |
O detalhe das ----[mla]---- liquidaçoes ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberações ------------ de dinheiro que incluem o saldo inicial e das transações que impactam o saldo total.

| +| Block |
Bloqueios de dinheiro por disputas.

| +| Unblock |
Desbloqueios após a resolução das disputas.

| +| Subtotal |
Soma das transações que compõem cada seção.

| +| Total|
Resultado final composto pela soma de todos os subtotais.

Ou seja:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = resultado total.

É a diferença entre o valor líquido total creditado e o valor líquido total debitado. | -Além disso, o relatório reflete os conceitos de *débito* (dinheiro a pagar) e *crédito* (dinheiro a receber) em duas colunas, uma para cada conceito: +Além disso, o relatório reflete os conceitos contábeis de débito (dinheiro que você precisa pagar) e crédito (dinheiro que você tem a receber), organizando o relatório em duas colunas, uma para cada conceito: -> Seu **a receber** estará na coluna `NET_CREDIT` +> Seu **crédito** estará na coluna `NET_CREDIT_AMOUNT`. >
-> Seu **a pagar** estará na coluna `NET_DEBIT` - -Você verá o saldo disponível das transações liberadas nas colunas `NET_CREDIT` (creditado) e `NET_DEBIT` (debitado), dependendo se o valor é positivo ou negativo. Você também verá aí o valor bruto e os gastos de financiamento, impostos e custos de envio que descontamos para chegar ao valor líquido. +> Sua **dívida** estará na coluna `NET_DEBIT_AMOUNT`. -**O que acontece se uma transferência não se concretizar?** +Os saldos disponíveis das transações são exibidos nas colunas `NET_CREDIT` (crédito) e `NET_DEBIT` (débito) de acordo com o valor positivo ou negativo. Nesses campos, também são detalhados o valor bruto e os descontos relativos a financiamentos, impostos e custos de envio, resultando no valor líquido final. -Caso isso aconteça, o relatório continuará válido. O dinheiro voltará à sua conta e a transação aparecerá no relatório em uma nova linha na coluna `NET_CREDIT`. +Caso uma transferência não seja concluída, o relatório permanecerá válido. O valor será reembolsado para sua conta e a transação será exibida em uma nova linha na coluna `NET_CREDIT`. > NOTE > > Importante > -> Tenha em mãos o [Glossário do relatório](/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ para consultá-lo quando precisar ou queira conferir algum termo técnico. +> Tenha em mãos o [Glossário do Relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](/developers/pt/guides/additional-content/reports/released-money/glossary) para consultá-lo quando precisar conferir algum termo técnico. -## Exemplo de um relatório - -Observe como está composto o relatório de dinheiro ----[mla]---- liquidado ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberado ------------ neste exemplo para identificar as seções e analisar seus próprios relatórios: +## Exemplo de relatório +Observe o que compõe o Relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ no seguinte exemplo para identificar as seções e analisar seus próprios relatórios: ----[mla]---- -![Relatório de liquidaçoes](/images/manage-account/reports/example-release-pt.jpg) +![Relatório de Liquidaçoes](/images/manage-account/reports/example-release-pt.jpg) ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- -![Relatório de liberações](/images/manage-account/reports/example-release-pt.jpg) +![Relatório de Liberações](/images/manage-account/reports/example-release-pt.jpg) ------------ - A versão padrão mostrará uma visualização estendida das colunas. O relatório final terá a maior quantidade de detalhes possível. -----[mpe]---- -## Como faço para analisar os relatórios gerados a partir de janeiro de 2022? ------------- -----[mlu]---- -## Como faço para analisar os relatórios gerados a partir de marchar de 2022? -----[mlc, mco]---- -## Como faço para analisar os relatórios gerados a partir de agosto de 2022? ------------- -----[mla, mlm]---- -## Como faço para analisar os relatórios gerados a partir de outubro de 2022? ------------- -----[mlb]---- -## Como faço para analisar os relatórios gerados a partir de janeiro de 2023? ------------- -----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- -Os relatórios que você gerar a partir de ------------ ----[mpe]----janeiro de 2022------------ ----[mlu]----marchar de 2022------------ ----[mla, mlm]----outubro de 2022------------ ----[mco, mlc]----agosto de 2022------------ ----[mlb]----janeiro de 2023------------ ----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- têm as seguintes características: : - -1. As movimentações são mostradas em ordem cronológica, o que permite identificá-las mais facilmente e ter ainda mais controle sobre suas vendas. -2. Caso haja alguma reclamação ou contestação referente a algum problema com o serviço ou produto oferecido, o valor correspondente fica retido até a mediação ser resolvida. Essas informações constam no seu relatório e você pode encontrá-las ao procurar pelo prefixo "reserve-". -3. As movimentações relacionadas aos saques e/ou transferências do seu saldo disponível aparecem como "Payout", e todas as mediações que surgirem quando uma reclamação for iniciada ou resolvida aparecem como "Dispute". Para conferir a descrição das demais movimentações e termos, consulte este glossário. - -## Quais informações constam no relatório? - -O relatório possui uma estrutura simplificada para que seja mais fácil entendê-lo: - -| Composição do relatório | Descrição | -| --- | --- | -| Initial Available Balance |
Saldo inicial. Indica o valor que estava disponível na data inicial do período que você selecionou para fazer a reconciliação.

| -| Release |
O detalhe das transações que impactam o saldo total.

| -| Total|
É a diferença entre o valor líquido total creditado e o valor líquido total debitado.

| - -## Exemplo de um relatório +## Organização do relatório -Confira neste exemplo como o relatório "Liberações" é composto para identificar as seções e analisar seus próprios relatórios: +Veja no exemplo a seguir a organização do relatório: ![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-pt.jpg) diff --git a/guides/additional-content/reports/released-money/introduction.pt.md b/guides/additional-content/reports/released-money/introduction.pt.md index 0ae243b366..6ee5f89008 100644 --- a/guides/additional-content/reports/released-money/introduction.pt.md +++ b/guides/additional-content/reports/released-money/introduction.pt.md @@ -1,70 +1,66 @@ ----[mla]---- -# O que é o relatório de Liquidações? +# Relatório de Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- -# O que é o relatório de Liberações? +# Relatório de Liberações ------------ -O relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ é um **relatório para ser baixado que te permite saber como seu saldo disponível está composto no Mercado Pago. Ou seja, quanto você tem para usar**. Ele contém **detalhes de todos os valores envolvidos em um período de tempo,** e inclui os casos de ----[mla]---- liquidaçao ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberação ------------ de dinheiro, como de bloqueios e desbloqueios. +O Relatório de----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ é um arquivo que pode ser baixado e que detalha o saldo que você tem disponível no Mercado Pago. Ele não apenas mostra o valor total disponível, mas também fornece informações sobre as transações realizadas em um período determinado, incluindo situações como bloqueios e desbloqueios de fundos. +Além disso, permite que você saiba se o seu dinheiro está disponível ou não, e você pode solicitar essa informação para o período de datas que for mais conveniente para você. Tenha em mente que atualmente este relatório só é gerado através do seu computador. + +----[mpe]---- +## Análise dos relatórios a partir de janeiro de 2022 +------------ +----[mlu]---- +## Análise dos relatórios a partir de marchar de 2022 +----[mlc, mco]---- +## Análise dos relatórios a partir de agosto de 2022 +------------ ----[mla, mlm]---- -> WARNING -> -> Importante -> -> Nos seus relatórios de outubro e dos próximos meses, suas movimentações estarão ordenadas por data de criação para que você possa identificá-las mais facilmente. +## Análise dos relatórios a partir de outubro de 2022 ------------ - ----[mlb]---- -> WARNING -> -> Importante -> -> Os relatórios gerados a partir de 1º de janeiro de 2023 vão apresentar suas movimentações em ordem cronológica, assim, você pode identificá-las mais facilmente e controlar ainda melhor as finanças dos seus negócios. [Confira o novo formato do relatório.](https://bit.ly/3UivgKt) +## Análise dos relatórios a partir de janeiro de 2023 ------------ -----[mlm]---- -> WARNING -> -> Importante -> -> Os relatórios gerados a partir de 3 de outubro vão apresentar suas movimentações em ordem cronológica, assim, você pode identificá-las mais facilmente e controlar ainda melhor as finanças dos seus negócios. [Confira o novo formato do relatório.](https://bit.ly/3QiCD2f) ------------- +Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022------------ ----[mlu]----marchar de 2022------------ ----[mla, mlm]----outubro de 2022------------ ----[mco, mlc]----agosto de 2022------------ ----[mlb]----janeiro de 2023------------ têm as seguintes características: -## Como baixar o relatório? +1. As movimentações são mostradas em ordem cronológica, o que permite identificá-las mais facilmente e ter ainda mais controle sobre suas vendas. +2. Caso haja alguma reclamação ou contestação referente a algum problema com o serviço ou produto oferecido, o valor correspondente fica retido até a mediação ser resolvida. Essas informações constam no seu relatório e você pode encontrá-las ao procurar pelo prefixo "reserve-". +3. As movimentações relacionadas aos saques e/ou transferências do seu saldo disponível aparecem como "Payout", e todas as mediações que surgirem quando uma reclamação for iniciada ou resolvida aparecem como "Dispute". Para conferir a descrição das demais movimentações e termos, consulte [o glossário](/developers/pt/docs/checkout-pro/additional-content/reports/released-money/report-use). +4. Você encontrará uma nova coluna chamada "Sale detail" ou "Detalhe da venda" que fornece informações detalhadas sobre os itens vendidos, facilitando a conciliação e o controle das suas vendas. Cada entrada nesta coluna mostra o primeiro elemento da venda, seguido pelo agrupamento de outros itens. -Lembre-se de que a geração deste relatório leva alguns minutos, dependendo de quantas informações você queira incluir nele. Nem sempre ele estará pronto de imediato e, enquanto estiver sendo gerado, você verá na tela o status *Em preparação*. +## Baixar relatório -Ao estar disponível, ele ficará na sua bandeja de relatórios e você poderá baixá-lo de duas formas: +Siga este caminho para saber como gerar e baixar o relatório de Liberações: +**Relatórios e faturamento -> Relatórios de vendas e extratos de conta -> Liberações**. -* Por um link de download que enviaremos via e-mail. -* Na sua conta Mercado Pago, vá até "Relatórios de pagamentos e extratos de conta" e selecione o relatório *Liberações*. +### Criar relatório por API -### Valores do relatório +Crie o relatório de Liberações manualmente quantas vezes desejar ou programe-o conforme suas necessidades de frequência por meio da [API](/developers/pt/docs/checkout-pro/additional-content/reports/released-money/api). -Dependendo das [tarifas e prazos](/settings/release-options) que você escolher, o dinheiro que você ganhar pela venda será liberado um tempo depois que o pagamento for creditado. Por isso, o valor total exibido no relatório nem sempre vai coincidir com o seu saldo total ou com o valor total que aparece nos relatórios de faturamento. +A geração do relatório leva alguns minutos, dependendo de quanta informação você deseja incluir. Nem sempre estará pronto instantaneamente e, até que esteja, você verá o status "Em preparação" na tela. -Os prazos de liberação têm relação com os tempos dos bancos ou com os fluxos de intermediação quando as transações são feitas no Mercado Livre. Outras transações que podem afetar a liberação do seu dinheiro são as Contestações e Reclamações que você possa receber na venda. +Consulta ["Como analisar o relatório de Liberações?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. +### Valores do relatório -> Para saber a data exata que o dinheiro de uma transação vai estar disponível, revise os [detalhes dos seus pagamentos creditados](/activities/balance). - -## Para que usar o relatório - -### Use o relatório para conciliar +Dependendo das [tarifas e prazos](/settings/release-options) selecionados, o valor obtido com a venda será liberado após o pagamento ser creditado. Por isso, o valor total indicado no relatório pode não coincidir sempre com seu saldo total ou com o valor total nos relatórios de faturamento. -**Este relatório é usado para conciliar** o dinheiro que existe na sua conta em um determinado momento e inclui as transações que o compõem. +Os prazos de liberação estão relacionados aos processos bancários e aos fluxos de intermediação quando as transações são feitas no Mercado Livre. Além disso, contestações e reclamações recebidas em vendas podem impactar a liberação do dinheiro. -Gere o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ toda vez que precisar reconciliar os detalhes do dinheiro liberado entre duas datas. Você poderá saber quando cada transação foi feita, em que conceito e por qual quantia. +> Para obter a data exata de disponibilidade do dinheiro de uma transação, é importante revisar os [detalhes dos pagamentos creditados](https://www.mercadopago.com.br/activities/balance). +## Utilizar relatório -### Use o relatório para conhecer seu histórico +O relatório de ----[mla]----Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ é uma ferramenta importante tanto para conciliação quanto para análise de seu histórico financeiro. Ele detalha as transações da conta, proporciona compreensão e conciliação do saldo disponível em datas determinadas e fornece dados de cada transação, incluindo data, conceito e valor. -Além disso, você pode usar o relatório para saber o histórico de dinheiro ----[mla]---- liquidado ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberado ------------ entre duas datas, o detalhe dos eventos que compõem uma transferência bancária, os detalhes de disputas, reembolsos, envios, estornos, impostos e outras transações. Você também verá os detalhes das parcelas liquidadas e as parcelas ainda a serem pagas. +Além disso, este relatório apresenta o histórico completo de dinheiro liberado, abordando eventos como transferências bancárias, disputas, reembolsos e estornos, e destaca as parcelas liquidadas em comparação às pendentes de pagamento. > NOTE > > Nota > -> Tenha em mãos o [Glossário do relatório](/developers/pt/guides/additional-content/reports/released-money/glossary) de dinheiro ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ para revisá-lo quando precisar ou caso queira consultar algum termo técnico. \ No newline at end of file +> Utilize o [Glossário do Relatório de----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago.com.br/developers/pt/docs/checkout-pro/additional-content/reports/released-money/report-use) para consulta de termos técnicos, caso necessário. \ No newline at end of file From 89f6a43e9e5d15f930601ce00d2b543e0eb9c951 Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 00:08:50 -0300 Subject: [PATCH 2/9] 1 --- .../reports/released-money/api.pt.md | 341 +++++++++--------- .../reports/released-money/generate.pt.md | 40 +- .../reports/released-money/glossary.pt.md | 19 +- .../reports/released-money/panel.pt.md | 22 +- 4 files changed, 203 insertions(+), 219 deletions(-) diff --git a/guides/additional-content/reports/released-money/api.pt.md b/guides/additional-content/reports/released-money/api.pt.md index 47cb2f727f..e87630ee80 100644 --- a/guides/additional-content/reports/released-money/api.pt.md +++ b/guides/additional-content/reports/released-money/api.pt.md @@ -1,146 +1,43 @@ -# Geração via API +# Gerar relatório via API Gere o relatório de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ manualmente quantas vezes quiser ou programe-o de acordo com a frequência desejada por meio de nossa API. -## Atributos configuráveis +## Configurar o relatório de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ + +### Atributos configuráveis Confira os campos que você pode configurar para ajustar as suas preferências antes de começar: > WARNING > -> Atenção -> -> Configurar este atributo de `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais detalhes, confira a seção [Agende seus relatórios.](#bookmark_agende_seus_relatórios_automáticos) - -| Campo configurável | Descrição | -| --- | --- | -| `columns` |
Campo com os detalhes das colunas a serem incluídas no seu relatório. Encontre todos os valores possíveis na seção [Glossário](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary).

| -| `file_name_prefix` |
Prefixo que compõe o nome do relatório assim que estiver gerado e pronto para baixar.

| -| `frequency` |
Indica a frequência diária, semanal ou mensal dos relatórios programados.

- `frequency` aplica type *monthly* ao dia do mês ou *weekly* ao dia da semana
- `hour` hora do dia que o relatório deve ser gerado
- `type` indica o tipo de frequência: *daily* (diária), *weekly* (semanal) y *monthly* (mensal).

| -| `sftp_info` (opcional) |
Indica os dados para subir a SFTP quando precisar.

| -| `separator` (opcional) |
Separador que pode ser usado no arquivo .csv quando não quiser que o separador seja uma vírgula (‘,’).

| -| `display_timezone` (opcional) |
Este campo determina a data e o horário mostrados nos relatórios. Se você não configurar um fuso horário para esse campo, o sistema considerará o fuso GMT-04 como padrão. Caso escolha um fuso que adote horário de verão, você precisará fazer o ajuste manual quando o horário mudar.

| -| `report_translation` (opcional) |
Permite mudar o idioma padrão dos cabeçalhos das colunas de relatórios gerados em formato Excel (.xlsx). Se você tiver uma integração com base nesse formato e configurar esse recurso, recomendamos que verifique se ela está funcionando corretamente.

Caso a integração não esteja funcionando corretamente, por favor, atualize-a tendo os novos cabeçalhos como referência.

| -| `notification_email_list` (opcional) |
Permite adicionar um grupo de destinatários de e-mail para que recebam uma notificação quando um relatório estiver pronto e disponível para download. Certifique-se de incluir o e-mail associado à sua conta Mercado Pago para que você também receba as notificações.

| -| `refund_detailed` (opcional) |
Mostra o código de referência (external_reference) do reembolso em vez do código de referência (external_reference) do pagamento.

| -| `include_withdrawal` (opcional) |
Inclui as retiradas de dinheiro no relatório.

| -| `coupon_detailed` (opcional) |
Inclui uma coluna para mostrar os detalhes dos cupons de desconto.

| -| `scheduled` (read_only) |
Campo informativo que indica se já existem relatórios programados na conta do usuário.
`True` A geração automática está ativada
`False` A geração automática está desativada

| -| `check_available_balance` (opcional) |
Saldo antes e depois de fazer um saque, que explica o balanço da conta. (Essa configuração é meramente informativa. Ela não deve ser considerada para comprovação de balanço e/ou saldo da conta).

| -| `compensate_detail` (opcional) |
Bloqueio e desbloqueio de dinheiro que se compensam entre si e que não afetam o saldo final. Ajuda a entender como é feito o balanço final do relatório, em um formato cronológico. (Configuração recomendada caso você tenha um grande volume de transações).

| - -## Configure seus relatórios - -> NOTE -> -> Nota -> -> Tenha em mãos o [Glossário](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) para conferir termos técnicos durante a geração do seu relatório. -Execute o _curl_ que você precisa para consultar, gerar e atualizar os seus relatórios. - -### Consulte seus configurações - -Consulte a configuração dos seus relatórios via API da seguinte maneira: - -[[[ -```curl -curl -X GET \ - -H 'accept: application/json' \ - -H 'content-type: application/json' \ - -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ - 'https://api.mercadopago.com/v1/account/release_report/config' \ -``` -```php - 'application/json', - 'content-type' => 'application/json', - 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' -); -$response = Requests::get('https://api.mercadopago.com/v1/account/release_report/config', $headers); -``` -```java - URL url = new URL("https://api.mercadopago.com/v1/account/release_report/config"); - -HttpsURLConnection connection = (HttpsURLConnection) url.openConnection(); - -connection.setRequestMethod("GET"); -connection.setRequestProperty("Accept", "application/json"); -connection.setRequestProperty("Content-Type", "application/json"); -connection.setRequestProperty("Authorization", "Bearer ENV_ACCESS_TOKEN"); - -System.out.println(connection.getResponseCode()); -System.out.println(connection.getResponseMessage()); -System.out.println(connection.getInputStream()); -``` -```python -import requests -headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -} - -response = requests.get('https://api.mercadopago.com/v1/account/release_report/config', headers=headers) -``` -```node -var request = require('request'); - -var headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -}; - -var options = { - url: 'https://api.mercadopago.com/v1/account/release_report/config', - headers: headers -}; -function callback(error, response, body) { - if (!error && response.statusCode == 200) { - console.log(body); - } -} -request(options, callback); -``` -]]] - -Você receberá um `HTTP STATUS 200 (Ok)` como resposta se nenhum erro for encontrado. - -O objeto de resposta terá uma estrutura semelhante ao exemplo abaixo: - -```json -{ - "file_name_prefix": "release-report-USER_ID", - "include_withdrawal_at_end": true, - "scheduled": false, - "execute_after_withdrawal": false, - "separator": ";", - "display_timezone": "GMT-04", - "frequency": { - "hour": 0, - "type": "monthly", - "value": 1 - }, - "columns": [ - { - "key": "DATE" - }, - { - "key": "SOURCE_ID" - }, - { - "key": "EXTERNAL_REFERENCE" - } - ] -} -``` - -### Crie as configurações - -Crie suas preferências de geração de relatório via API para exportar colunas, nomear seus arquivos e configurar outros ajustes: +> Importante +> +> Configurar o atributo `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais informações, confira a seção [Agendar relatório automático.](#bookmark_agendar_relatório_automático) + +| Campo configurável | Tipo | Exemplo | Descrição | +|---------------------------|------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `columns` | JSON Array | ``` [{"key": "DATE"}, {"key": "SOURCE_ID"}] ``` | Campo com os detalhes das colunas a serem incluídas no seu relatório. Encontre todos os valores possíveis na seção [Glossário](/developers/pt/docs/checkout-pro/additional-content/reports/released-money/report-use). | +| `file_name_prefix` | String | "conciliation-settlement-report" | Prefixo que compõe o nome do relatório gerado e pronto para download. | +| `frequency` | JSON | ``` {"hour": 0, "type": "monthly", "value": 1} ``` | Indica a frequência diária, semanal ou mensal dos relatórios programados.
- `frequency`: aplica type _monthly_ ao dia do mês ou _weekly_ ao dia da semana.
- `hour`: hora do dia que o relatório deve ser gerado.
- `type`: indica o tipo de frequência: _daily_ (diária), _weekly_ (semanal) y _monthly_ (mensal). | +| `sftp_info` (opcional) | JSON | ``` {"server": "sftp.myserver.com", "password": "mypassword", "remote_dir": "/myfolder", "port": 22, "username": "myusername"} ``` | Fornece os dados de conexão necessários para acessar o servidor.
- `server`: URL ou endereço IP (pública) do servidor.
- `password`: senha do usuário com o qual estabeleceremos a conexão.
- `remote_dir`: pasta onde depositaremos seus relatórios.
- `port`: porta usada para estabelecer a conexão.
- `username`: usuário com o qual nos autenticaremos no seu servidor.
| +| `separator` (opcional) | String | ";" | Separador alternativo para arquivos _csv_ quando se deseja utilizar um caractere diferente da vírgula (','). | +| `display_timezone` (opcional)| String | "GMT-04" | Este campo determina a data e o horário mostrados nos relatórios. Se você não configurar um fuso horário para esse campo, o sistema considerará o fuso GMT-04 como padrão. Caso escolha um fuso que adote horário de verão, você precisará fazer o ajuste manual quando o horário mudar. | +| `report_translation` (opcional)| String | "es" | Permite alterar o idioma padrão dos cabeçalhos das colunas. Caso esteja ativado, recomenda-se verificar se as integrações com arquivos do Excel (_xlsx_) estão funcionando corretamente para permitir a conciliação automática. Caso a integração não esteja funcionando corretamente, por favor, atualize-a tendo os novos cabeçalhos como referência. Idiomas suportados: en (Inglês), es (Espanhol neutro), pt (Português). | +| `notification_email_list` (opcional)| Array| ``` ["example@email.com", "john@example.com"] ``` | Permite adicionar um grupo de destinatários de e-mail para que recebam uma notificação quando um relatório estiver pronto e disponível para download. Certifique-se de incluir o e-mail associado à sua conta Mercado Pago para que você também receba as notificações. | +| `refund_detailed` (opcional) | Boolean | true | Mostra o código de referência (`external_reference`) do reembolso em vez do código de referência (`external_reference`) do pagamento. | +| `include_withdrawal` (opcional)| Boolean | true | Inclui as retiradas de dinheiro no relatório. | +| `coupon_detailed` (opcional)| Boolean | true | Inclui uma coluna para mostrar os detalhes dos cupons de desconto. | +| `scheduled` (read_only) | Boolean | true | Campo informativo que indica se já existem relatórios programados na conta do usuário.
- `True`: A geração automática está ativada. - `False`: A geração automática está desativada. | +| `check_available_balance` (opcional)| Boolean| true | Saldo antes e depois de fazer um saque, que explica o balanço da conta. (Esta configuração é meramente informativa. Ela não deve ser considerada para comprovação de balanço e/ou saldo da conta). | +| `compensate_detail` (opcional)| Boolean | true | Bloqueio e desbloqueio de dinheiro que se compensam entre si e que não afetam o saldo final. Ajuda a entender como é feito o balanço final do relatório, em um formato cronológico (configuração recomendada caso você tenha um grande volume de transações). | + +Você pode configurar seus relatórios conforme necessário. Abaixo, destacamos as chamadas de API disponíveis para que você possa gerenciar a configuração do seu relatório e, posteriormente, com base nessas configurações, gerar os relatórios. + +> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. + +## Criar uma nova configuração + +Personalize seus relatórios atribuindo diferentes propriedades de criação executando o seguinte _curl_: [[[ ```curl @@ -346,9 +243,9 @@ request(options, callback); ``` ]]] -Você receberá um `HTTP STATUS 201 (Created)` como resposta se nenhum erro for encontrado. +Na ausência de erros, será emitido um código de status `HTTP 201 (Created)`. A API responderá com uma estrutura JSON, cujas propriedades representarão a configuração que você criou. -O objeto de resposta terá uma estrutura semelhante ao exemplo abaixo: +#### Resposta ```json { @@ -381,15 +278,115 @@ O objeto de resposta terá uma estrutura semelhante ao exemplo abaixo: } ``` -### Atualizando configurações +### Consultar configurações + +Consulte a configuração atual dos seus relatórios executando o seguinte _curl_: + +[[[ +```curl +curl -X GET \ + -H 'accept: application/json' \ + -H 'content-type: application/json' \ + -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ + 'https://api.mercadopago.com/v1/account/release_report/config' \ +``` +```php + 'application/json', + 'content-type' => 'application/json', + 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' +); +$response = Requests::get('https://api.mercadopago.com/v1/account/release_report/config', $headers); +``` +```java + URL url = new URL("https://api.mercadopago.com/v1/account/release_report/config"); + +HttpsURLConnection connection = (HttpsURLConnection) url.openConnection(); + +connection.setRequestMethod("GET"); +connection.setRequestProperty("Accept", "application/json"); +connection.setRequestProperty("Content-Type", "application/json"); +connection.setRequestProperty("Authorization", "Bearer ENV_ACCESS_TOKEN"); + +System.out.println(connection.getResponseCode()); +System.out.println(connection.getResponseMessage()); +System.out.println(connection.getInputStream()); +``` +```python +import requests +headers = { + 'accept': 'application/json', + 'content-type': 'application/json', + 'Authorization': 'Bearer ENV_ACCESS_TOKEN' +} + +response = requests.get('https://api.mercadopago.com/v1/account/release_report/config', headers=headers) +``` +```node +var request = require('request'); + +var headers = { + 'accept': 'application/json', + 'content-type': 'application/json', + 'Authorization': 'Bearer ENV_ACCESS_TOKEN' +}; + +var options = { + url: 'https://api.mercadopago.com/v1/account/release_report/config', + headers: headers +}; +function callback(error, response, body) { + if (!error && response.statusCode == 200) { + console.log(body); + } +} +request(options, callback); +``` +]]] + +Na ausência de erros, será emitido um código de status HTTP 200 (Ok). A API responderá com uma estrutura JSON cujas propriedades representarão as características dos seus relatórios. + +#### Resposta + +```json +{ + "file_name_prefix": "release-report-USER_ID", + "include_withdrawal_at_end": true, + "scheduled": false, + "execute_after_withdrawal": false, + "separator": ";", + "display_timezone": "GMT-04", + "frequency": { + "hour": 0, + "type": "monthly", + "value": 1 + }, + "columns": [ + { + "key": "DATE" + }, + { + "key": "SOURCE_ID" + }, + { + "key": "EXTERNAL_REFERENCE" + } + ] +} +``` + +### Atualizar configurações + +Atualize as configurações predefinidas dos seus relatórios quando necessário executando o _curl_ abaixo. > NOTE > > Nota > ->Se, ao atualizar a configuração, você quiser alterar o atributo "Frequency", e já tiver ativado a geração automática dos seus relatórios, siga estes passos:

1. Cancele a geração agendada dos seus relatórios, seguindo os passos na seção [Desativação](#bookmark_2._desativação).
2. Atualize a configuração alterando o atributo `frequency` pelos snippets disponíveis nessa seção.
3. Agende novamente a geração automática do relatório, seguindo os passos da seção [Ativação](#bookmark_1._ativação). - -Quando precisar atualizar as configurações predefinidas de relatório, ajuste os seguintes atributos: +> Se, ao atualizar a configuração, você quiser alterar o atributo `frequency`, e já tiver ativado a criação automática dos seus relatórios, siga os seguintes passos:

1. Cancele a criação agendada dos seus relatórios seguindo os passos descritos na seção [Desativar criação automática](#bookmark_2._desativar_criacao_automatica).
2. Atualize a configuração.
3. Habilite novamente a criação automática dos seus relatórios seguindo os passos da seção [Ativar criação automática](#bookmark_1._ativação). [[[ ```curl @@ -595,9 +592,9 @@ request(options, callback); ``` ]]] -Você receberá um `HTTP STATUS 200 (Ok)` como resposta se nenhum erro for encontrado. +Na ausência de erros, será emitido um código de status HTTP 200 (Ok). A API responderá com uma estrutura JSON cujas propriedades representarão a configuração que você atualizou. -O objeto de resposta terá uma estrutura semelhante ao exemplo abaixo: +#### Resposta ```json { @@ -630,13 +627,13 @@ O objeto de resposta terá uma estrutura semelhante ao exemplo abaixo: } ``` -## Gerando seus relatórios manualmente +## Criar relatório manualmente -Gere seus relatórios de forma manual configurando três instâncias: criação, consulta e *download*. +Você tem à sua disposição vários recursos que permitirão interagir com seus relatórios manualmente. -### 1. Criação +### Criar relatório -Faça uma chamada POST à API especificando as datas de início e fim desejadas, assim: +Faça uma requisição POST à API para gerar manualmente um novo relatório dentro de um intervalo de datas específico: [[[ ```curl @@ -727,16 +724,16 @@ request(options, callback); ``` ]]] -Você receberá um `HTTP STATUS 202 (Accepted)` como resposta se nenhum erro for encontrado, e o relatório será criado de forma assincrônica. +Na ausência de erros, será emitido um código de status `HTTP 202 (Accepted)`. Após isso, o seu relatório será gerado de forma assíncrona. Você receberá como resposta uma estrutura JSON com informações relevantes ao seu pedido de criação. ----[mlm, mla, mco, mpe, mlu, mlc]---- Uma resposta `HTTP STATUS 203 (Non-Authoritative Information)` indica que a solicitação ocorreu conforme o esperado, apesar disso, não foi possível criar seu relatório e será necessário solicitá-lo novamente com as datas indicadas no sistema. ------------ -### 2. Consulta +### Consultar relatório -Para conferir se a criação do relatório está pronta, consulte a API desta forma: +Consulte a API conforme abaixo para explorar a lista de relatórios que você gerou: [[[ ```curl @@ -798,9 +795,9 @@ request(options, callback); ``` ]]] -Você receberá um `HTTP STATUS 200 (Ok)` como resposta se nenhum erro for encontrado. +Na ausência de erros, será emitido um código de status `HTTP 200 (Ok)`. A API responderá com um JSON Array no qual você encontrará a lista de todos os relatórios que gerou. -O objeto de resposta terá uma estrutura semelhante ao exemplo a seguir: +#### Resposta ```json [ @@ -819,9 +816,9 @@ O objeto de resposta terá uma estrutura semelhante ao exemplo a seguir: ] ``` -### 3. Download +### Baixar relatório -Usando o atributo `file_name`, você pode baixar o relatório na seguinte URL: +Usando o atributo `file_name`, você pode baixar qualquer um de seus relatórios na seguinte URL: [[[ ```curl @@ -885,10 +882,9 @@ request(options, callback); ``` ]]] +Na ausência de erros, será emitido um código de status `HTTP 200 (Ok)`. Na resposta da API, você terá à disposição o arquivo do relatório que solicitou baixar. -Você receberá um `HTTP STATUS 200 (Ok)` se nenhum erro for encontrado. - -O objeto de resposta terá uma estrutura semelhante ao exemplo a seguir: +#### Resposta ```csv DATE,SOURCE_ID,EXTERNAL_REFERENCE,RECORD_TYPE,DESCRIPTION,NET_CREDIT_AMOUNT,NET_DEBIT_AMOUNT,GROSS_AMOUNT,MP_FEE_AMOUNT,FINANCING_FEE_AMOUNT,SHIPPING_FEE_AMOUNT,TAXES_AMOUNT,COUPON_AMOUNT,INSTALLMENTS,PAYMENT_METHOD @@ -900,17 +896,14 @@ DATE,SOURCE_ID,EXTERNAL_REFERENCE,RECORD_TYPE,DESCRIPTION,NET_CREDIT_AMOUNT,NET_ 2018-04-17T15:38:40.000-04:00,,,release,payment,850.00,0.00,850.00,0.00,0.00,0.00,0.00,0.00,1,account_money ``` -## Agende seus relatórios automáticos - -Gere seus relatórios de forma programada configurando duas instâncias: ativação e desativação. +## Agendar relatório automaticamente -### 1. Ativação +Crie seus relatórios de forma programada configurando duas instâncias: ativação e desativação. -Programe a criação automática do seu relatório usando a frequência desejada no recurso de configuração. +### Ativar criação automática -Atualize o atributo *`scheduled`* na configuração para *`true`*: +Programe a geração automática do relatório utilizando a frequência atribuída durante a configuração dos seus relatórios. Ao consumir este serviço, a propriedade `scheduled` da sua configuração será atualizada automaticamente para `true`: -`POST /v1/account/release_report/schedule` [[[ ```curl @@ -986,9 +979,9 @@ request(options, callback); ]]] -Você receberá um HTTP STATUS 200 (OK) em resposta se nenhum erro for encontrado. +Na ausência de erros, será emitido um código de status `HTTP 200 (OK)`. A API responderá com uma estrutura JSON na qual você encontrará informações associadas ao relatório que você agendou. -O objeto de resposta terá uma estrutura semelhante ao exemplo de cancelamento de relatório a seguir: +#### Resposta ```json { @@ -1005,7 +998,9 @@ O objeto de resposta terá uma estrutura semelhante ao exemplo de cancelamento d } ``` -### 2. Desativação +### Desativar criação automática + +Pode desativar a geração automática dos seus relatórios a qualquer momento, quando necessário. Ao consumir este serviço, a propriedade `scheduled` da sua configuração será atualizada automaticamente para `false`. [[[ ```curl @@ -1077,9 +1072,9 @@ request(options, callback); ``` ]]] -Você receberá um `HTTP STATUS 200 (OK)` em resposta se nenhum erro for encontrado. +Na ausência de erros, será emitido um código de status `HTTP 200 (OK)`. A API responderá com uma estrutura JSON na qual você encontrará informações associadas ao relatório que desativou. -O objeto de resposta terá uma estrutura semelhante ao exemplo de cancelamento de relatório a seguir: +#### Resposta ```json { @@ -1094,10 +1089,4 @@ O objeto de resposta terá uma estrutura semelhante ao exemplo de cancelamento d "status": "deleted", "user_id": USER_ID } -``` - -> NOTE -> -> Esta documentação corresponde à nova versão da API -> -> Para consultar a versão anterior, por favor, acesse a [seção Geração por API antiga](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/v1/api). \ No newline at end of file +``` \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/generate.pt.md b/guides/additional-content/reports/released-money/generate.pt.md index 5726dafc95..4d23517441 100644 --- a/guides/additional-content/reports/released-money/generate.pt.md +++ b/guides/additional-content/reports/released-money/generate.pt.md @@ -1,4 +1,6 @@ -# Como gerar o seu relatório de Liberações? +# Gerar relatório + +Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ através da sua conta Mercado Pago ou por meio da integração via API. Veja a tabela a seguir para obter mais informações. ----[mla]---- > NOTE @@ -13,27 +15,27 @@ Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ pela sua conta Mercado Pago: -| Canais | Descrição | -| --- | --- | -| Painel do Mercado Pago | Para gerar um relatório manualmente pelo Mercado Pago, vá até a seção [Relatórios e faturamento](https://www.mercadopago[FAKER][URL][DOMAIN]/movements) clique em "Ir para Relatórios de pagamentos e extratos de conta" e escolha o relatório que desejar.

Siga o passo a passo para [gerar seus relatórios a partir do painel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/panel). | -| Integração via API | Para gerar manualmente o report ou agendar um de acordo com a frequência desejada, use a nossa integração via API.

Leia a documentação para [gerar relatórios por API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api). | +| Canais | Descrição | +|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Painel do Mercado Pago | É possível criar o relatório manualmente através do painel Mercado Pago. Acesse a seção de [Relatórios e faturamento](https://www.mercadopago.com.br/movements), clique em **Ir para Relatórios de pagamentos e extratos de conta** e selecione o relatório. Para mais informações, leia a documentação [Gerar relatório pelo painel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/panel). | +| Integração via API | Crie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte as documentações [Gerar relatório via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api), [Gerar relatório manualmente](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/manual) ou [Agendar relatório automaticamente](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/automatic) a depender da opção pretendida. | ## Características técnicas do relatório -Considere as seguintes informações técnicas sempre que for gerar, programar e configurar seus relatórios. +Considere as seguintes informações técnicas sempre que for criar, programar ou configurar um relatório. ### Estrutura do relatório -Saiba as características dos elementos que compõem seu relatório. +Entenda as características dos elementos que compõem seu relatório. | Ações e componentes | Características | | --- | --- | -| Detalhes das tablas | Os detalhes das tabelas compreende as informações no mínimo de 1 dia. | +| Detalhes das tabelas | Os detalhes das tabelas compreendem as informações de no mínimo 1 dia. | | Ordem das colunas | Fixa | | Período máximo | Relatórios com dados de até 60 dias. | | Moeda | Local (com base no país onde está cadastrada a conta do Mercado Pago) | | Fuso horário das colunas: | GMT-4

Tome como referência o lugar de onde o relatório é baixado. | -| Seleção de datas via web | Deve ter como base o fuso horário da conta do usuário.
Por exemplo, a conta do usuário cadastrada no Brasil corresponde ao fuso horário de São Paulo. | +| Seleção de datas via web | Com base no fuso horário da conta do usuário.
Por exemplo, a conta do usuário cadastrada no Brasil corresponde ao fuso horário de São Paulo. | ### Exportação do relatório @@ -41,21 +43,21 @@ Todas as opções disponíveis na hora de baixar seu relatório. | Ações e componentes | Características | | --- | --- | -| Formato do nome do arquivo | Quando o relatório é programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2019.csv | -| Formatos de download | .csv, .xlsx

Dica: baixe o relatório em .csv para importar os dados e usá-los em outros aplicativos. Baixe-o em .xlsx para ler as informações nas tabelas da planilha. | -| Arquivo | Os relatórios gerados ficam salvos na sua conta do Mercado Pago. | +| Formato do nome do arquivo | Relatório programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2019.csv. | +| Formatos de download | ._csv_, ._xlsx_

**Nota**: baixe o relatório em ._csv_ para importar os dados e usá-los em outros aplicativos. Baixe-o em ._xlsx_ para ler as informações em tabelas de planilha. | +| Arquivo | Os relatórios gerados são salvos na sua conta do Mercado Pago. | ## Notificações ### Webhook -Webhook (também conhecido como "retorno de chamada web"), é um método simples que permite que um aplicativo ou sistema forneça informações em tempo real toda vez que um evento acontece, ou seja, é uma maneira de receber dados entre dois sistemas de forma passiva, por meio de um HTTP POST. No caso dos relatórios usados na reconciliação, uma notificação é enviada ao usuário que tiver configurado este serviço quando seus arquivos forem gerados. +Webhook, também chamado de "retorno de chamada web", é um método eficiente para receber informações em tempo real sempre que um evento ocorre em um aplicativo ou sistema. Essa abordagem permite a transferência passiva de dados entre dois sistemas por meio de solicitações HTTP POST. Em relação aos relatórios utilizados na reconciliação, uma notificação é enviada ao usuário que tiver configurado este serviço assim que os arquivos correspondentes forem gerados. | Atributo | Descrição | |-----------------|-----------------------------------| | transaction_id | ID da transação | | request_date | Data da solicitação | -| generation_date | Data da geração | +| generation_date | Data da criação | | files | Arquivos disponíveis | | type | Formato do arquivo | | url | Link de download | @@ -68,16 +70,16 @@ Webhook (também conhecido como "retorno de chamada web"), é um método simples ### Senha para criptografia -Para garantir o processo de notificação ao sistema, será enviado no corpo da mensagem (payload) um atributo chamado **_"signature"_** para validar que a notificação Webhook teve origem no Mercado Pago e que não se trata de uma imitação. +A senha de criptografia é essencial para assegurar o processo de notificação ao sistema. No corpo da mensagem (_payload_), um atributo chamado **_"signature"_** é enviado para validar a origem legítima da notificação Webhook do Mercado Pago, evitando possíveis imitações. -A **signature** é criada ao unir o `transaction_id` com a `senha criptografada` na seção **_"Notificação por Webhook"_** e o `generation_date` do relatório. Assim que os valores forem vinculados, eles são criptografados usando o algoritmo **_BCrypt_** da seguinte maneira: +A criação da **signature** ocorre pela combinação do `transaction_id` com a `senha criptografada` na seção **_"Notificação por Webhook"_**, juntamente com o `generation_date` do relatório. Esses valores são então criptografados utilizando o algoritmo **_BCrypt_** da seguinte forma: `signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)` -Para validar que foi o Mercado Pago quem emitiu a notificação, é necessário usar a **_função de verificação oferecida_** pelo algoritmo do **_BCrypt_** para a linguagem desejada. +Para validar que foi o Mercado Pago quem emitiu a notificação, é necessário utilizar a **_função de verificação oferecida_** pelo algoritmo do **_BCrypt_** para a linguagem desejada. -**Exemplo Java:** +**Exemplo em Java:** `BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)` -> Tenha em mãos o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ para consultá-lo quando precisar ou queira conferir algum termo técnico. \ No newline at end of file +> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/glossary.pt.md b/guides/additional-content/reports/released-money/glossary.pt.md index 499937349f..b8268f9637 100644 --- a/guides/additional-content/reports/released-money/glossary.pt.md +++ b/guides/additional-content/reports/released-money/glossary.pt.md @@ -1,6 +1,6 @@ # Glossário -Sabemos que alguns termos são técnicos e você pode não estar familiarizado com todos eles. Use este glossário para não se perder! +Veja a descrição de cada campo presente no relatório na tabela abaixo. ----[mla, mlm]---- > WARNING @@ -20,32 +20,32 @@ Sabemos que alguns termos são técnicos e você pode não estar familiarizado c | Nome da coluna do relatório| O que significa | |----------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Data da liberação (DATE) | Data de liberação, bloqueio ou desbloqueio, conforme se aplicar. | -| ID da operação no Mercado Pago (SOURCE_ID) | ID da operação no Mercado Pago (por exemplo, o pagamento de uma venda). | -| ID da operação no Mercado Pago (EXTERNAL_REFERENCE)|
Este dado permite identificar uma transação com base na sua origem. O código pode ser:
- ID da venda, por meio do pedido ou do envio (caso seja uma compra do carrinho)
- ID próprio, fornecido pelo vendedor, caso seja uma integração externa
----[mla]---- - ID gerado pela Coelsa, instituição que processa transferências para outras contas

------------ ----[mlc, mco, mlm, mlb]----
------------É possível que esse campo fique vazio para alguns casos, como por exemplo, o pagamento de faturas ou uma transferência de dinheiro, entre outros.

| +| Data da liberação (DATE) | Data de liberação da transação. É o momento em que essa transação afeta o saldo disponível na conta do usuário. | +| ID da operação no Mercado Pago (SOURCE_ID) | Identificador da transação nos sistemas do Mercado Pago. Exemplo: ID de um Pagamento. | +| ID da operação no Mercado Pago (EXTERNAL_REFERENCE)|
Este dado permite identificar uma transação com base na sua origem. O código pode ser:
- ID da venda, por meio do pedido ou do envio (caso seja uma compra do carrinho)
- ID próprio, fornecido pelo vendedor, caso seja uma integração externa. Estes dados permitem relacionar transações (registros) entre o Mercado Pago e sistemas externos
----[mla]---- - ID gerado pela Coelsa, instituição que processa transferências para outras contas

------------ ----[mlc, mco, mlm, mlb]----
------------É possível que esse campo fique vazio para alguns casos, como por exemplo, o pagamento de faturas ou uma transferência de dinheiro, entre outros.

| | Tipo de registro (RECORD_TYPE) |
`initial_available_balance` → Dinheiro disponível do período anterior.

`release` → Dinheiro de uma cobrança que foi liberado.

`total` → Valor líquido total.

`available_balance` → saldo antes e depois de fazer um saque ou transferência, que explica o balanço da conta.

| -| Descrição (DESCRIPTION) | Possíveis valores que o campo pode assumir:
----[mlb]----, judgment_bacen, fraud ------------

Para `release`: Pagamento (payment), Transferência (withdrawal), Devolução de dinheiro (refund), ----[mla]----Pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires (tax_payment_ibcf), Cancelamento do pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires (tax_payment_ibcf_cancel), ------------ Pagamento do imposto IBEX (tax_payment_ibex), Pagamento do Imposto de renda (tax_payment_iibb), Cancelamento do pagamento do imposto de renda (tax_payment_iibb_cancel, shipping), Devolução de dinheiro - Frete (shipping_cancel), tax_withdholding, Retenção de imposto (tax_withdholding_cancel), Contestação (chargeback), Pagamento de tarifa - Antecipação de dinheiro (fee_release_in_advance), Rendimentos positivos (asset_management_gain), Rendimentos negativos (asset_management_loss), Trava de recebível (trava_de_recibibles) ----[mpe, mlu, mlc, mco, mla, mlm, mlb]----

Para Saldo disponível `available_balance`: o campo mostra o prefixo "pre" e "pos" para indicar o saldo antes ou depois de um saque ou transferência, conforme o caso, seguido do tipo de transação, neste caso, uma transferência de dinheiro Saques (payout) e, por último, o número de identificação da transação ou o ID Source.

Prefixo + nome da transação + número da transação.

Exemplo: pre_payout_ID source

pre_payout_1948976543
pos_payout_1948976543 ------------

Definições a considerar:

Contestação `chargeback`: aparece quando uma contestação associada ao pagamento a que se refere é iniciada ou resolvida.

Contestação `dispute`: aparece quando uma mediação ou reclamação sobre o pagamento referido é iniciada ou resolvida. Pode ocorrer antes ou depois que o pagamento tenha sido liberado como dinheiro disponível e até mesmo retirado da conta.

Tarifa por devolução do frete `shipping_return`: aparece quando um pagamento por devolução agilizada é bloqueado ou desbloqueado.

Pagamento `payment`: pagamento liberado em qualquer um dos canais em que o cliente opera.

Devolução de dinheiro `refund`: devolução associada ao pagamento referido.

`shipping_refund`: valor da devolução feita referente ao frete ou ao imposto vinculado ao frente.

----[mla]---- Pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires `tax_payment_ibcf`: arrecadação da receita bruta em Capital Federal, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Cancelamento do pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires `tax_payment_ibcf_cancel`: cancelamento do imposto de renda bruto em Capital Federal.

Pagamento do imposto IBEX `tax_payment_ibex`: arrecadação da receita bruta por sujeito excedido do regime simplificado, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Pagamento do Imposto IIBB `tax_payment_iibb`: arrecadação da receita bruta na província de Buenos Aires, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Cancelamento do pagamento do imposto renda `tax_payment_iibb_cancel`: cancelamento do imposto da receita bruta.

Retenção de imposto cancelada `tax_withdholding`: a cobrança de retenções que não puderam ser executadas para o pagamento associado. Na Argentina são apenas retenções de receita bruta (arrecadações são debitadas como outra operação), enquanto no Uruguai são retenções de IVA e, na Colômbia, são retenções de IVA, ICA e Fonte, conforme aplicável.

------------ Pagamento do imposto de renda jurisdição `tax_payment_iibb_cre_[jurisdição]`: imposto sobre Receita Bruta - Mercado Crédito, em que substitui-se `[jurisdição]` pelo nome do estado onde o imposto é gerado.
----[mla]----Exemplo 1: Pagamento do imposto IIBB - Misiones - Mercado Crédito (tax_payment_iibb_cre_misiones)
Exemplo 2: Pagamento do imposto IIBB - San Luís - Mercado Crédito(tax_payment_iibb_cre_san_luis)
------------ Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Retenção do imposto IIBB - jurisdição `tax_iibb_[jurisdição]`: imposto sobre Receita Bruta, em que substitui-se `[jurisdição]` pelo nome do estado onde o imposto é gerado.
----[mla]----Exemplo 1: Exemplo 1: Retenção do imposto IIBB - Misiones (tax_iibb_misiones)
Exemplo 2: Retenção do imposto IIBB - San Luís (tax_iibb_san_luis)
------------ Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Imposto sobre valor agregado `tax_iva`: IVA - Regime Geral.

Imposto sobre valor agregado - Mercado Crédito `tax_iva_cre`: IVA - Regime Geral - Mercado Crédito.

----[mla]----Imposto sobre créditos e débitos `tax_credit_debit`: Imposto sobre créditos e débitos em vigor na Argentina, a partir de 1º de agosto de 2021, para pessoas jurídicas. Esse imposto se aplica a todas as transações feitas com terceiros, depósitos e saques de dinheiro. [Saiba mais sobre este imposto](https://www.mercadopago.com.ar/ayuda/20783).

------------ Retenção de imposto cancelada `tax_withdholding_cancel`: o cancelamento da retenção tax_withdholding.

Imposto sobre créditos e débitos em pagamentos `tax_withholding_payer`: imposto sobre créditos e débitos em pagamentos.

Imposto sobre créditos e débitos em recebimentos `tax_withholding_collector`: imposto sobre créditos e débitos em cobranças.

Imposto sobre créditos e débitos em transferências/saques `tax_withholding_payout`: Imposto sobre créditos e débitos em saques.

Imposto sobre créditos e débitos nos envios `tax_withholding_shipping`: imposto sobre créditos e débitos em transferências.

Frete `shipping`: tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Devolução de dinheiro - Frete `shipping_cancel`: cancelamento da tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Contestação `chargeback`: contestação a favor ou contra uma operação.

Pagamento de tarifa - Antecipação de dinheiro `fee-release_in_advance`: tarifa de antecipação.

Rendimentos positivos `asset_management_gain`: rendimento positivo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento.

Rendimentos negativos `asset_management_loss`: rendimento negativo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento

Restrição `restriction`: ocorre quando uma restrição é aplicada por comportamento fraudulento.

Pagamento de crédito `credit_payment`: aparece quando a parcela de um crédito é debitada.

Saque de dinheiro `payout`: saque em dinheiro ou transferência por PIX de saldo disponível no Mercado Pago.

Reserva para bloqueio de dinheiro investido `reserve_for_embargo_invested`: bloqueio do seu dinheiro em rendimento. Este valor aparece quando há uma reserva de dinheiro em fundos de investimento.

Reserva para devolução do envio BPP `reserve_for_bpp_shipping_return`: reserva para devoluções.

Reserva para pagamento de dívida `reserve_for_debt_payment`: retido para pagamento de dívida.

Reserva para reembolso `reserve_for_refund`: retido para devoluções aprovadas.

Reserva devido a contestação em conta vinculada. `reserve_for_cbk_cross_recovery`: retido por contestaçao de conta vinculada.

Reserva para pagamento `reserve_for_payment`: gastos pendentes de confirmação. ----[mlb]----

`judgment_bacen`: ordem judicial do Banco Central. O dinheiro pode estar congelado na conta devido a algum litígio em andamento. Pode estar associado a bloqueios de valores.

revisão de segurança. `fraud`: revisão de segurança.

Trava de recebível `trava_de_recibibles`: trava de recebível. ------------

`digitalchange_transaction`: Transação de Troco virtual. Entrada ou saída de dinheiro na conta. Se você for vendedor, corresponde ao troco que você deu virtualmente a um comprador referente a um pagamento feito em dinheiro. Se você for comprador, corresponde ao troco que recebeu por uma compra que pagou em dinheiro. | +| Descrição (DESCRIPTION) | Possíveis valores que o campo pode assumir:
----[mlb]----, judgment_bacen, fraud ------------

Para `release`: Pagamento (payment), Transferência (withdrawal), Devolução de dinheiro (refund), ----[mla]----Pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires (tax_payment_ibcf), Cancelamento do pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires (tax_payment_ibcf_cancel), ------------ Pagamento do imposto IBEX (tax_payment_ibex), Pagamento do Imposto de renda (tax_payment_iibb), Cancelamento do pagamento do imposto de renda (tax_payment_iibb_cancel, shipping), Devolução de dinheiro - Frete (shipping_cancel), tax_withdholding, Retenção de imposto (tax_withdholding_cancel), Contestação (chargeback), Pagamento de tarifa - Antecipação de dinheiro (fee_release_in_advance), Rendimentos positivos (asset_management_gain), Rendimentos negativos (asset_management_loss), Trava de recebível (trava_de_recibibles) ----[mpe, mlu, mlc, mco, mla, mlm, mlb]----

Para Saldo disponível `available_balance`: o campo mostra o prefixo "pre" e "pos" para indicar o saldo antes ou depois de um saque ou transferência, conforme o caso, seguido do tipo de transação - neste caso, uma transferência de dinheiro Saques (payout) seguida pelo número de identificação da transação ou o ID Source.

Prefixo + nome da transação + número da transação.

Exemplo: pre_payout_ID source

pre_payout_1948976543
pos_payout_1948976543 ------------

Definições a considerar:

Contestação `chargeback`: aparece quando uma contestação associada ao pagamento a que se refere é iniciada ou resolvida.

Contestação `dispute`: aparece quando uma mediação ou reclamação sobre o pagamento referido é iniciada ou resolvida. Pode ocorrer antes ou depois que o pagamento tenha sido liberado como dinheiro disponível e até mesmo retirado da conta.

Tarifa por devolução do frete `shipping_return`: aparece quando um pagamento por devolução agilizada é bloqueado ou desbloqueado.

Pagamento `payment`: pagamento liberado em qualquer um dos canais em que o cliente opera.

Devolução de dinheiro `refund`: devolução associada ao pagamento referido.

`shipping_refund`: valor da devolução feita referente ao frete ou ao imposto vinculado ao frente.

----[mla]---- Pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires `tax_payment_ibcf`: arrecadação da receita bruta em Capital Federal, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Cancelamento do pagamento do imposto IBCF - Cidade Autônoma de Buenos Aires `tax_payment_ibcf_cancel`: cancelamento do imposto de renda bruto em Capital Federal.

Pagamento do imposto IBEX `tax_payment_ibex`: arrecadação da receita bruta por sujeito excedido do regime simplificado, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Pagamento do Imposto IIBB `tax_payment_iibb`: arrecadação da receita bruta na província de Buenos Aires, calculada uma vez por mês de acordo com as operações transacionadas. Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Cancelamento do pagamento do imposto renda `tax_payment_iibb_cancel`: cancelamento do imposto da receita bruta.

Retenção de imposto cancelada `tax_withdholding`: a cobrança de retenções que não puderam ser executadas para o pagamento associado. Na Argentina são apenas retenções de receita bruta (arrecadações são debitadas como outra operação), enquanto no Uruguai são retenções de IVA e, na Colômbia, são retenções de IVA, ICA e Fonte, conforme aplicável.

------------ Pagamento do imposto de renda jurisdição `tax_payment_iibb_cre_[jurisdição]`: imposto sobre Receita Bruta - Mercado Crédito, em que substitui-se `[jurisdição]` pelo nome do estado onde o imposto é gerado.
----[mla]----Exemplo 1: Pagamento do imposto IIBB - Misiones - Mercado Crédito (tax_payment_iibb_cre_misiones)
Exemplo 2: Pagamento do imposto IIBB - San Luís - Mercado Crédito(tax_payment_iibb_cre_san_luis)
------------ Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Retenção do imposto IIBB - jurisdição `tax_iibb_[jurisdição]`: imposto sobre Receita Bruta, em que substitui-se `[jurisdição]` pelo nome do estado onde o imposto é gerado.
----[mla]----Exemplo 1: Exemplo 1: Retenção do imposto IIBB - Misiones (tax_iibb_misiones)
Exemplo 2: Retenção do imposto IIBB - San Luís (tax_iibb_san_luis)
------------ Para reconciliar por operação, consulte os detalhes nos [Relatórios de faturas no MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Imposto sobre valor agregado `tax_iva`: IVA - Regime Geral.

Imposto sobre valor agregado - Mercado Crédito `tax_iva_cre`: IVA - Regime Geral - Mercado Crédito.

----[mla]----Imposto sobre créditos e débitos `tax_credit_debit`: Imposto sobre créditos e débitos em vigor na Argentina, a partir de 1º de agosto de 2021, para pessoas jurídicas. Esse imposto se aplica a todas as transações feitas com terceiros, depósitos e saques de dinheiro. [Saiba mais sobre este imposto](https://www.mercadopago.com.ar/ayuda/20783).

------------ Retenção de imposto cancelada `tax_withdholding_cancel`: o cancelamento da retenção tax_withdholding.

Imposto sobre créditos e débitos em pagamentos `tax_withholding_payer`: imposto sobre créditos e débitos em pagamentos.

Imposto sobre créditos e débitos em recebimentos `tax_withholding_collector`: imposto sobre créditos e débitos em cobranças.

Imposto sobre créditos e débitos em transferências/saques `tax_withholding_payout`: Imposto sobre créditos e débitos em saques.

Imposto sobre créditos e débitos nos envios `tax_withholding_shipping`: imposto sobre créditos e débitos em transferências.

Frete `shipping`: tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Devolução de dinheiro - Frete `shipping_cancel`: cancelamento da tarifa de envio para compras de carrinho que não está incluída em cada pagamento do carrinho.

Contestação `chargeback`: contestação a favor ou contra uma operação.

Pagamento de tarifa - Antecipação de dinheiro `fee-release_in_advance`: tarifa de antecipação.

Rendimentos positivos `asset_management_gain`: rendimento positivo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento.

Rendimentos negativos `asset_management_loss`: rendimento negativo gerado pela variação do valor de quotas adquiridas no fundo comum de investimento

Restrição `restriction`: ocorre quando uma restrição é aplicada por comportamento fraudulento.

Pagamento de crédito `credit_payment`: aparece quando a parcela de um crédito é debitada.

Saque de dinheiro `payout`: saque em dinheiro ou transferência por PIX de saldo disponível no Mercado Pago.

Reserva para bloqueio de dinheiro investido `reserve_for_embargo_invested`: bloqueio do seu dinheiro em rendimento. Este valor aparece quando há uma reserva de dinheiro em fundos de investimento.

Reserva para devolução do envio BPP `reserve_for_bpp_shipping_return`: reserva para devoluções.

Reserva para pagamento de dívida `reserve_for_debt_payment`: retido para pagamento de dívida.

Reserva para reembolso `reserve_for_refund`: retido para devoluções aprovadas.

Reserva devido a contestação em conta vinculada. `reserve_for_cbk_cross_recovery`: retido por contestação de conta vinculada.

Reserva para pagamento `reserve_for_payment`: gastos pendentes de confirmação. ----[mlb]----

`judgment_bacen`: ordem judicial do Banco Central. O dinheiro pode estar congelado na conta devido a algum litígio em andamento. Pode estar associado a bloqueios de valores.

revisão de segurança. `fraud`: revisão de segurança.

Trava de recebível `trava_de_recibibles`: trava de recebível. ------------

`digitalchange_transaction`: Transação de Troco virtual. Entrada ou saída de dinheiro na conta. Se você for vendedor, corresponde ao troco que você deu virtualmente a um comprador referente a um pagamento feito em dinheiro. Se você for comprador, corresponde ao troco que recebeu por uma compra que pagou em dinheiro. | | Valor líquido debitado (NET_DEBIT_AMOUNT) | Creditado no valor disponível. | | Valor líquido creditado (NET_CREDIT_AMOUNT) | Debitado do valor disponível.| | Valor recebido por compras com split de pagamento (SELLER_AMOUNT) | Valor recebido por compras com split. | | Valor bruto da operação (GROSS_AMOUNT) | Valor bruto da transação. | | Dados adicionais (METADATA)| Dados extras, como por exemplo, o ID dos reembolsos parciais ou dados fornecidos pelo vendedor no caso de integrações externas. ----[mlb]---- Quando "Fee discount" aparecer, entende-se como a redução na tarifa de venda pela participação em uma campanha comercial. ------------ | | Tarifa do Mercado Pago ou do Mercado Livre (MP_FEE_AMOUNT) | Pagamento da tarifa do Mercado Pago e/ou Mercado Livre. ----[mla, mpe, mco, mlm, mlu, mlc]---- Inclui IVA. ------------ | -| Tarifa por oferecer parcelamento sem juros (FINANCING_FEE_AMOUNT) | Custo for oferecer parcelamento quando o custo dessa taxa for assumido pelo seller. | +| Tarifa por oferecer parcelamento sem juros (FINANCING_FEE_AMOUNT) | Custo por oferecer parcelamento quando o custo dessa taxa for assumido pelo seller. | | Frete (SHIPPING_FEE_AMOUNT)| Custo de envio. | | Impostos cobrados por retenções de receita bruta (TAXES_AMOUNT) | ----[mlm, mlc, mlu, mlb, mco, mpe]----Impostos recebidos por retenção de receita bruta.------------ ----[mla]----Impostos cobrados por retenção de Receita Bruta na fonte, IVA, Lucros; e impostos sobre Créditos e Débitos, entre outros. [Saiba mais sobre retenções e impostos.](https://vendedores.mercadolibre.com.ar/nota/retenciones-y-percepciones-sobre-tus-ventas-lo-que-debes-saber)------------ | | Cupom de desconto (COUPON_AMOUNT) | Esta transação mostra o valor total do cupom de desconto que é oferecido aos seus compradores. | | Parcelas (INSTALLMENTS) | Número de parcelas em que a transação foi feita. | | Meio de pagamento (PAYMENT METHOD) | [Meios de pagamentos disponíveis](/developers/pt/docs/sales-processing/payment-methods) de acordo com o país com o qual você opera no Mercado Pago. | -| Detalhes dos impostos (TAX_DETAIL) |
Descrição do imposto retido por transação nos impostos cobrados por retenções de receita bruta `TAXES_AMOUNT`. ----[mla]---- Você pode considerar os seguintes valores conforme a jurisdição:
cordoba
corrientes
mendoza
la_pampa
santa_fe
tucuman
entre_rios
catamarca
neuquen
santiago_del_estero
rio_negro
jujuy ------------ ----[mco]---- Você pode considerar os seguintes valores conforme a jurisdição:
fuente
iva
ica
Imposto 4x1000 (GMF)
------------

| +| Detalhes dos impostos (TAX_DETAIL) |
Descrição do imposto retido por transação nos impostos cobrados pelas retenções de receita bruta `TAXES_AMOUNT`. ----[mla]---- Você pode considerar os seguintes valores conforme a jurisdição:
cordoba
corrientes
mendoza
la_pampa
santa_fe
tucuman
entre_rios
catamarca
neuquen
santiago_del_estero
rio_negro
jujuy ------------ ----[mco]---- Você pode considerar os seguintes valores conforme a jurisdição:
fuente
iva
ica
Imposto 4x1000 (GMF)
------------

| | Imposto descontado do valor bruto para telecomunicações (TAX_AMOUNT_TELCO) | É o valor do imposto às empresas de telecomunicação descontado do valor bruto. | | Data de aprovação (TRANSACTION_APPROVAL_DATE) | Data de aprovação da transação.| | ID do caixa (POS_ID) | ID do caixa, se o pagamento é feito em comércio físico.| | Nome do caixa (POS_NAME) | Nome do caixa para o pagamento feito em um comércio físico. | -| ID do caixa, definido pelo usuário (EXTERNAL_POS_ID) | ID da lojal definido pelo usuário para o pagamento feito em um comércio físico.| +| ID do caixa, definido pelo usuário (EXTERNAL_POS_ID) | ID da loja definido pelo usuário para o pagamento feito em um comércio físico.| | ID do pedido (STORE_ID) | ID da loja se o pagamento é feito em um comércio físico. | | Nome da loja (STORE_NAME)| Nome do caixa para o pagamento feito em um comércio físico. | -| ID do caixa, definido pelo usuário (EXTERNAL_STORE_ID) | ID da lojal definido pelo usuário para o pagamento feito em um comércio físico.| +| ID do caixa, definido pelo usuário (EXTERNAL_STORE_ID) | ID da loja definido pelo usuário para o pagamento feito em um comércio físico.| | ID do pedido (ORDER_ID) | Pedido de compra. | | ID do envio (SHIPPING_ID)| Identificador de envio. | | Forma de envio (SHIPMENT_MODE) | Modalidade de envio. | @@ -65,6 +65,7 @@ Sabemos que alguns termos são técnicos e você pode não estar familiarizado c | Conta de destino da retirada (PAYOUT_BANK_ACCOUNT_NUMBER) | Aqui será exibido o número da conta para onde o dinheiro do Mercado Pago foi transferido. | | Código do produto SKU (PRODUCT_SKU) | Código SKU, com o qual você poderá identificar seus produtos vendidos. | | Detalhe da venda (SALE_DETAIL) | Esta coluna oferece informações detalhadas sobre os itens vendidos em cada entrega, facilitando a conciliação e o controle de suas vendas. | + > INFO > > (*) Estas informações só podem ser usadas para fins de reconciliação e serão tratadas de acordo com as leis de diff --git a/guides/additional-content/reports/released-money/panel.pt.md b/guides/additional-content/reports/released-money/panel.pt.md index 5b46506ed7..55eef29daf 100644 --- a/guides/additional-content/reports/released-money/panel.pt.md +++ b/guides/additional-content/reports/released-money/panel.pt.md @@ -1,17 +1,9 @@ -# Geração pelo painel do Mercado Pago +# Gerar relatório pelo painel -Gere seus relatórios de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ a partir do seu painel do Mercado Pago. +Gere seus relatórios de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ a partir do seu painel do Mercado Pago. Você poderá programar para que o relatório seja gerado cada vez que você fizer um saque do seu saldo para uma conta bancária. Para isso, siga as etapas abaixo: +1. A partir da sua conta do Mercado Pago, clique em [Relatórios e faturamento](https://www.mercadopago.com.br/balance/reports) no menu esquerdo. +2. Selecione a opção [[----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------]](https://www.mercadopago.com.br/balance/reports/release) e clique em **Criar relatório**. +3. Busque as transações por período de tempo e selecione as que deseja conciliar. +4. Clique em **Gerar**. O relatório estará _Em preparação_ e você receberá um e-mail quando estiver pronto. -Siga estas etapas para gerar seus relatórios: - -1. A partir da sua conta do Mercado Pago, vá para os seus [Relatórios](https://www.mercadopago.com.ar/balance/reports) e escolha a opção de **Relatório**. -2. Vá em [relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago.com.ar/balance/reports/release) e clique em *Gerar relatório*. -3. Busque as transações por período de tempo e selecione as que quer conciliar. - -Pronto! Você verá seu relatório *Em preparação*. - -> NOTE -> -> Importante -> -> Tenha em mãos o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ para consultá-lo quando precisar ou queira conferir algum termo técnico. \ No newline at end of file +> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file From 7b8bc653f7814e3a5bc175311b801086673a237d Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 00:11:46 -0300 Subject: [PATCH 3/9] 3 --- guides/additional-content/reports/released-money/generate.pt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/additional-content/reports/released-money/generate.pt.md b/guides/additional-content/reports/released-money/generate.pt.md index 4d23517441..d5ce18ad8c 100644 --- a/guides/additional-content/reports/released-money/generate.pt.md +++ b/guides/additional-content/reports/released-money/generate.pt.md @@ -18,7 +18,7 @@ Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[ | Canais | Descrição | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Painel do Mercado Pago | É possível criar o relatório manualmente através do painel Mercado Pago. Acesse a seção de [Relatórios e faturamento](https://www.mercadopago.com.br/movements), clique em **Ir para Relatórios de pagamentos e extratos de conta** e selecione o relatório. Para mais informações, leia a documentação [Gerar relatório pelo painel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/panel). | -| Integração via API | Crie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte as documentações [Gerar relatório via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api), [Gerar relatório manualmente](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/manual) ou [Agendar relatório automaticamente](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/automatic) a depender da opção pretendida. | +| Integração via API | Crie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte as documentações [Gerar relatório via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api). | ## Características técnicas do relatório From d88883a78ed6d70e89f872fe5ac1dc442dee21bc Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 00:40:01 -0300 Subject: [PATCH 4/9] 4 --- .../general-considerations/reconciliation-reports.pt.md | 3 +-- guides/additional-content/reports/released-money/api.pt.md | 2 +- .../reports/released-money/generate.pt.md | 6 +++--- .../reports/released-money/glossary.pt.md | 3 +-- .../reports/released-money/how-to-use.pt.md | 4 +--- .../reports/released-money/introduction.pt.md | 4 ++-- .../additional-content/reports/released-money/panel.pt.md | 4 ++-- 7 files changed, 11 insertions(+), 15 deletions(-) diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md index d981a13ead..0f86440159 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.pt.md @@ -14,7 +14,6 @@ Confira a tabela abaixo para mais detalhes sobre os tipos de relatório disponí |---|---| | Relatório Liberações | Informa a composição do saldo disponível na sua conta, com detalhes sobre os valores envolvidos em um determinado período. Leia a [documentação de Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para mais informações. | | Relatório Dinheiro em conta | Informa as transações/movimentações que afetaram seu saldo em conta. Para mais informações, leia a [documentação de Dinheiro em conta](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/account-money/introduction). | -| Relatório Dinheiro disponível | Apresenta a liquidez do seu negócio, detalhando o valor disponível em conta para uso. Para obter mais informações, leia a [documentação de Dinheiro disponível](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/available-money/introduction). -

* **Este relatório não está mais disponível**. Utilize o [Relatório de Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para conciliar as transações que compõem o saldo disponível em sua conta, incluindo saques bancários. | +| Relatório Dinheiro disponível | Apresenta a liquidez do seu negócio, detalhando o valor disponível em conta para uso. Para obter mais informações, leia a [documentação de Dinheiro disponível](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/available-money/introduction).
**Este relatório não está mais disponível**. Utilize o [Relatório de Liberações](https://www.mercadopago.com.br/developers/pt/guides/additional-content/reports/released-money/introduction) para conciliar as transações que compõem o saldo disponível em sua conta, incluindo saques bancários. | | Relatórios de faturamento | A **equipe de Marketplace do Mercado Livre** desenvolveu uma série de relatórios de faturamento, para disponibilizar os detalhes financeiros das transações realizadas no Mercado Pago a partir das vendas no Mercado Livre.

Os dados dos relatórios também contemplam informações financeiras de usuários que não realizam vendas pelo Mercado Livre, uma vez que os dados de faturamento são do Mercado Pago. Para mais informações, acesse a [documentação](https://developers.mercadolivre.com.br/pt_br/relatorios-de-faturamento#Resumen).| | Relatório de vendas da solução split de pagamentos do Mercado Pago | O relatório de vendas da solução split de pagamentos do Mercado Pago oferece um panorama completo das transações de vendedores vinculados, disponível para download nos formatos csv e json. Para saber mais, leia a [documentação](https://www.mercadopago.com.br/developers/pt/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/api.pt.md b/guides/additional-content/reports/released-money/api.pt.md index e87630ee80..6544f0702e 100644 --- a/guides/additional-content/reports/released-money/api.pt.md +++ b/guides/additional-content/reports/released-money/api.pt.md @@ -12,7 +12,7 @@ Confira os campos que você pode configurar para ajustar as suas preferências a > > Importante > -> Configurar o atributo `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais informações, confira a seção [Agendar relatório automático.](#bookmark_agendar_relatório_automático) +> Configurar o atributo `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais informações, confira a seção [Agendar relatório automático.](#bookmark_agendar_relatório_automaticamente) | Campo configurável | Tipo | Exemplo | Descrição | |---------------------------|------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| diff --git a/guides/additional-content/reports/released-money/generate.pt.md b/guides/additional-content/reports/released-money/generate.pt.md index d5ce18ad8c..965ac54baa 100644 --- a/guides/additional-content/reports/released-money/generate.pt.md +++ b/guides/additional-content/reports/released-money/generate.pt.md @@ -18,7 +18,7 @@ Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[ | Canais | Descrição | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Painel do Mercado Pago | É possível criar o relatório manualmente através do painel Mercado Pago. Acesse a seção de [Relatórios e faturamento](https://www.mercadopago.com.br/movements), clique em **Ir para Relatórios de pagamentos e extratos de conta** e selecione o relatório. Para mais informações, leia a documentação [Gerar relatório pelo painel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/panel). | -| Integração via API | Crie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte as documentações [Gerar relatório via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api). | +| Integração via API | Crie o relatório de forma manual ou agendada de acordo com a frequência desejada utilizando nossa integração via API. Para mais informações, consulte a documentação [Gerar relatório via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/api). | ## Características técnicas do relatório @@ -33,7 +33,7 @@ Entenda as características dos elementos que compõem seu relatório. | Detalhes das tabelas | Os detalhes das tabelas compreendem as informações de no mínimo 1 dia. | | Ordem das colunas | Fixa | | Período máximo | Relatórios com dados de até 60 dias. | -| Moeda | Local (com base no país onde está cadastrada a conta do Mercado Pago) | +| Moeda | Local (com base no país onde está cadastrada a conta do Mercado Pago). | | Fuso horário das colunas: | GMT-4

Tome como referência o lugar de onde o relatório é baixado. | | Seleção de datas via web | Com base no fuso horário da conta do usuário.
Por exemplo, a conta do usuário cadastrada no Brasil corresponde ao fuso horário de São Paulo. | @@ -82,4 +82,4 @@ Para validar que foi o Mercado Pago quem emitiu a notificação, é necessário `BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)` -> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file +> Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/glossary.pt.md b/guides/additional-content/reports/released-money/glossary.pt.md index b8268f9637..ccc53a8ebe 100644 --- a/guides/additional-content/reports/released-money/glossary.pt.md +++ b/guides/additional-content/reports/released-money/glossary.pt.md @@ -70,5 +70,4 @@ Veja a descrição de cada campo presente no relatório na tabela abaixo. > > (*) Estas informações só podem ser usadas para fins de reconciliação e serão tratadas de acordo com as leis de > proteção de dados pessoais aplicáveis. Elas estarão disponíveis quando pagamentos via código QR e transferências forem -> recebidos ou quando uma doação for recebida por uma ONG. ------------- +> recebidos ou quando uma doação for recebida por uma ONG. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/how-to-use.pt.md b/guides/additional-content/reports/released-money/how-to-use.pt.md index 41e6b41256..45310eb453 100644 --- a/guides/additional-content/reports/released-money/how-to-use.pt.md +++ b/guides/additional-content/reports/released-money/how-to-use.pt.md @@ -48,6 +48,4 @@ A versão padrão mostrará uma visualização estendida das colunas. O relatór Veja no exemplo a seguir a organização do relatório: -![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-pt.jpg) - ------------- \ No newline at end of file +![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-pt.jpg) \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.pt.md b/guides/additional-content/reports/released-money/introduction.pt.md index 6ee5f89008..b702866219 100644 --- a/guides/additional-content/reports/released-money/introduction.pt.md +++ b/guides/additional-content/reports/released-money/introduction.pt.md @@ -43,7 +43,7 @@ Crie o relatório de Liberações manualmente quantas vezes desejar ou programe- A geração do relatório leva alguns minutos, dependendo de quanta informação você deseja incluir. Nem sempre estará pronto instantaneamente e, até que esteja, você verá o status "Em preparação" na tela. -Consulta ["Como analisar o relatório de Liberações?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. +> Consulta ["Como analisar o relatório de Liberações?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. ### Valores do relatório @@ -51,7 +51,7 @@ Dependendo das [tarifas e prazos](/settings/release-options) selecionados, o val Os prazos de liberação estão relacionados aos processos bancários e aos fluxos de intermediação quando as transações são feitas no Mercado Livre. Além disso, contestações e reclamações recebidas em vendas podem impactar a liberação do dinheiro. -> Para obter a data exata de disponibilidade do dinheiro de uma transação, é importante revisar os [detalhes dos pagamentos creditados](https://www.mercadopago.com.br/activities/balance). +> Para obter a data exata de disponibilidade do dinheiro de uma transação, é importante revisar os [detalhes dos pagamentos creditados.](https://www.mercadopago.com.br/activities/balance) ## Utilizar relatório diff --git a/guides/additional-content/reports/released-money/panel.pt.md b/guides/additional-content/reports/released-money/panel.pt.md index 55eef29daf..540e6af4ad 100644 --- a/guides/additional-content/reports/released-money/panel.pt.md +++ b/guides/additional-content/reports/released-money/panel.pt.md @@ -2,8 +2,8 @@ Gere seus relatórios de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ a partir do seu painel do Mercado Pago. Você poderá programar para que o relatório seja gerado cada vez que você fizer um saque do seu saldo para uma conta bancária. Para isso, siga as etapas abaixo: 1. A partir da sua conta do Mercado Pago, clique em [Relatórios e faturamento](https://www.mercadopago.com.br/balance/reports) no menu esquerdo. -2. Selecione a opção [[----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------]](https://www.mercadopago.com.br/balance/reports/release) e clique em **Criar relatório**. +2. Selecione a opção [----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago.com.br/balance/reports/release) e clique em **Criar relatório**. 3. Busque as transações por período de tempo e selecione as que deseja conciliar. 4. Clique em **Gerar**. O relatório estará _Em preparação_ e você receberá um e-mail quando estiver pronto. -> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file +> Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file From 147805fc1ad7c79cabaf212cc7f5e23778204d9a Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 01:22:04 -0300 Subject: [PATCH 5/9] 10 --- .../reports/released-money/api.pt.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/guides/additional-content/reports/released-money/api.pt.md b/guides/additional-content/reports/released-money/api.pt.md index 6544f0702e..25a1fbc0fe 100644 --- a/guides/additional-content/reports/released-money/api.pt.md +++ b/guides/additional-content/reports/released-money/api.pt.md @@ -12,7 +12,7 @@ Confira os campos que você pode configurar para ajustar as suas preferências a > > Importante > -> Configurar o atributo `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais informações, confira a seção [Agendar relatório automático.](#bookmark_agendar_relatório_automaticamente) +> Configurar o atributo `frequency` não significa que o relatório será gerado automaticamente. A configuração será aplicada somente quando o agendamento automático for ativado. Para mais informações, confira a seção [Agendar relatório automaticamente.](#bookmark_agendar_relatório_automaticamente) | Campo configurável | Tipo | Exemplo | Descrição | |---------------------------|------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -33,7 +33,7 @@ Confira os campos que você pode configurar para ajustar as suas preferências a Você pode configurar seus relatórios conforme necessário. Abaixo, destacamos as chamadas de API disponíveis para que você possa gerenciar a configuração do seu relatório e, posteriormente, com base nessas configurações, gerar os relatórios. -> Tenha o [Glossário do relatório](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ à mão para consulta sempre que necessário ou para conferir algum termo técnico. +> Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. ## Criar uma nova configuração @@ -347,7 +347,7 @@ request(options, callback); ``` ]]] -Na ausência de erros, será emitido um código de status HTTP 200 (Ok). A API responderá com uma estrutura JSON cujas propriedades representarão as características dos seus relatórios. +Na ausência de erros, será emitido um código de status `HTTP 200 (Ok)`. A API responderá com uma estrutura JSON cujas propriedades representarão as características dos seus relatórios. #### Resposta @@ -386,7 +386,7 @@ Atualize as configurações predefinidas dos seus relatórios quando necessário > > Nota > -> Se, ao atualizar a configuração, você quiser alterar o atributo `frequency`, e já tiver ativado a criação automática dos seus relatórios, siga os seguintes passos:

1. Cancele a criação agendada dos seus relatórios seguindo os passos descritos na seção [Desativar criação automática](#bookmark_2._desativar_criacao_automatica).
2. Atualize a configuração.
3. Habilite novamente a criação automática dos seus relatórios seguindo os passos da seção [Ativar criação automática](#bookmark_1._ativação). +> Se, ao atualizar a configuração, você quiser alterar o atributo `frequency`, e já tiver ativado a criação automática dos seus relatórios, siga os seguintes passos:

1. Cancele a criação agendada dos seus relatórios seguindo os passos descritos na seção **Desativar criação automática** em [Agendar relatório automaticamente.](#bookmark_agendar_relatório_automaticamente)
2. Atualize a configuração.
3. Habilite novamente a criação automática dos seus relatórios seguindo os passos da seção **Ativar criação automática** em [Agendar relatório automaticamente.](#bookmark_agendar_relatório_automaticamente) [[[ ```curl @@ -592,7 +592,7 @@ request(options, callback); ``` ]]] -Na ausência de erros, será emitido um código de status HTTP 200 (Ok). A API responderá com uma estrutura JSON cujas propriedades representarão a configuração que você atualizou. +Na ausência de erros, será emitido um código de status `HTTP 200 (Ok)`. A API responderá com uma estrutura JSON cujas propriedades representarão a configuração que você atualizou. #### Resposta From e149a2b56c67f39c446b39185e5d1356824e7c9a Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 05:30:23 -0300 Subject: [PATCH 6/9] 20 --- .../reports/released-money/api.en.md | 304 ++++++-------- .../reports/released-money/api.es.md | 379 ++++++++---------- .../reports/released-money/generate.en.md | 94 ++--- .../reports/released-money/generate.es.md | 99 ++--- .../reports/released-money/generate.pt.md | 2 +- .../reports/released-money/glossary.en.md | 8 +- .../reports/released-money/glossary.es.md | 12 +- .../reports/released-money/how-to-use.en.md | 87 ++-- .../reports/released-money/how-to-use.es.md | 93 ++--- .../reports/released-money/introduction.en.md | 66 +-- .../reports/released-money/introduction.es.md | 77 ++-- .../reports/released-money/introduction.pt.md | 12 +- .../reports/released-money/panel.en.md | 22 +- .../reports/released-money/panel.es.md | 16 +- .../reports/released-money/panel.pt.md | 6 +- 15 files changed, 545 insertions(+), 732 deletions(-) diff --git a/guides/additional-content/reports/released-money/api.en.md b/guides/additional-content/reports/released-money/api.en.md index e55c7edadf..12ab67161a 100644 --- a/guides/additional-content/reports/released-money/api.en.md +++ b/guides/additional-content/reports/released-money/api.en.md @@ -1,147 +1,43 @@ -# Generating through API +# Generate Report via API -Generate the Released money report manually as many times as you want or schedule it according to the desired frequency through our API. +Generate the Release Report manually as many times as you want or schedule it according to the desired frequency through our API. -## Configurable attributes +## Configure the Release Report -Know the fields you can configure to adjust your preferences before you start: +### Configurable attributes + +Check the fields you can configure to adjust your preferences before starting: > WARNING > > Important > -> Setting up `frequency` feature does not mean that the report will be generated automatically. The settings will apply only when the automatic scheduling is activated. For more details, please go to the [Schedule your automatic reports](#bookmark_schedule_your_automatic_reports) section. - -| Configurable field | Description | -| --- | --- | -| `columns` |
Field with the details of columns to be included in your report. Find all possible values in the [Glossary section](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary).

| -| `file_name_prefix` |
Prefix that composes the report name once generated and ready for download.

| -| `frequency` |
Indicates the daily, weekly or monthly frequency of scheduled reports.

- `frequency` applies type *monthly* to the day of the month or *weekly* to the day of the week.
- `hour` Hour Time of day to generate the report.
- `type` Type indicates the type of frequency *daily*, *weekly* and *monthly*.

| -| `sftp_info` (optional) |
Indicates the uploaded data to SFTP when you need it.

| -| `separator` (optional) |
Separator that you can use in the .csv file when you don't want the separator to be a comma.

| -| `display_timezone` (optional) |
This field determines the date and time displayed in the reports. If you do not set a time zone in this field, the system will consider GMT-04 as default. If you choose a time zone which adopts daylight saving time, you will need to adjust it manually when the time changes.

| -| `report_translation` (optional) |
Allows you to change the default language of the column headers in reports that are generated in Excel format (.xlsx). If you have an integration based on this format and configure this feature, we recommend that you verify if it works correctly.

If your integration does not work properly, update it based on the new headers.

| -| `notification_email_list` (optional) |
Allows you to add a group of e-mail recipients to be notified when a report is ready and available for download. Make sure to include the email linked to your Mercado Pago account so you can be notified as well.

| -| `refund_detailed` (optional) |
Displays the reference code (external_reference) of the refund instead of the reference code (external_reference) of the payment.

| -| `include_withdrawal` (optional) |
Includes withdrawals in the report.

| -| `coupon_detailed` (optional) |
Includes a column to show the detail of the discount coupons.

| -| `scheduled` (read_only) |
Informative field that indicates if there are already scheduled reports in the user account.
`True` The automatic generation is activated
`False` The automatic generation is disabled

| -| `check_available_balance` (optional) |
Balance before and after a cash withdrawal, which explains the account balance. (This configuration is only informative. It should not be considered for balance and/or account balance checks).

| -| `compensate_detail` (optional) |
Blocking and unblocking of money that offset each other and do not affect the final balance. Helps to understand how the final balance of the report is made up, in a chronological format. (This setting is recommended if you have a high volume of transactions).

| - -## Set up your reports - -You can configure your reports according to your preferences. Up next, you'll find the API calls you can make to create, consult and update your reports. - -> NOTE -> -> Note -> -> Have the [Glossary](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/release-money/glossary) at hand to review technical terms when managing your reports. - -### Check the configuration - -You can check the configuration of your reports by API using these codes: - -[[[ -```curl -curl -X GET \ - -H 'accept: application/json' \ - -H 'content-type: application/json' \ - -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ - 'https://api.mercadopago.com/v1/account/release_report/config' \ -``` -```php - 'application/json', - 'content-type' => 'application/json', - 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' -); -$response = Requests::get('https://api.mercadopago.com/v1/account/release_report/config', $headers); -``` -```java - URL url = new URL("https://api.mercadopago.com/v1/account/release_report/config"); - -HttpsURLConnection connection = (HttpsURLConnection) url.openConnection(); - -connection.setRequestMethod("GET"); -connection.setRequestProperty("Accept", "application/json"); -connection.setRequestProperty("Content-Type", "application/json"); -connection.setRequestProperty("Authorization", "Bearer ENV_ACCESS_TOKEN"); - -System.out.println(connection.getResponseCode()); -System.out.println(connection.getResponseMessage()); -System.out.println(connection.getInputStream()); -``` -```python -import requests -headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -} - -response = requests.get('https://api.mercadopago.com/v1/account/release_report/config', headers=headers) -``` -```node -var request = require('request'); - -var headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -}; - -var options = { - url: 'https://api.mercadopago.com/v1/account/release_report/config', - headers: headers -}; -function callback(error, response, body) { - if (!error && response.statusCode == 200) { - console.log(body); - } -} -request(options, callback); -``` -]]] +> Configuring the `frequency` attribute does not mean that the report will be generated automatically. The configuration will only be applied when automatic scheduling is activated. For more information, see the section [Schedule report automatically.](#bookmark_schedule_report_automatically) -You will receive an `HTTP STATUS 200 (OK)` in response if no error is found. +| Configurable field | Type | Example | Description | +|---------------------------|------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `columns` | JSON Array | ``` [{"key": "DATE"}, {"key": "SOURCE_ID"}] ``` | Field with details of the columns to be included in your report. Find all possible values in the [Glossary](/developers/en/docs/checkout-pro/additional-content/reports/released-money/report-use). | +| `file_name_prefix` | String | "conciliation-settlement-report" | Prefix that composes the name of the generated and ready-to-download report. | +| `frequency` | JSON | ``` {"hour": 0, "type": "monthly", "value": 1} ``` | Indicates the daily, weekly, or monthly frequency of scheduled reports.
- `frequency`: applies type _monthly_ to the day of the month or _weekly_ to the day of the week.
- `hour`: the time of day the report should be generated.
- `type`: indicates the type of frequency: _daily_, _weekly_, or _monthly_. | +| `sftp_info` (optional) | JSON | ``` {"server": "sftp.myserver.com", "password": "mypassword", "remote_dir": "/myfolder", "port": 22, "username": "myusername"} ``` | Provides the necessary connection data to access the server.
- `server`: URL or IP address (public) of the server.
- `password`: password of the user with which we will establish the connection.
- `remote_dir`: folder where we will deposit your reports.
- `port`: port used to establish the connection.
- `username`: user with which we will authenticate on your server.
| +| `separator` (optional) | String | ";" | Alternative separator for _csv_ files when a character other than a comma (',') is desired. | +| `display_timezone` (optional)| String | "GMT-04" | This field determines the date and time shown in the reports. If you do not configure a time zone for this field, the system will consider GMT-04 as the default time zone. If you choose a time zone that observes daylight saving time, you will need to manually adjust it when the time changes. | +| `report_translation` (optional)| String | "es" | Allows changing the default language of column headers. If enabled, it is recommended to check if Excel file (_xlsx_) integrations are working correctly to allow automatic reconciliation. If the integration is not working correctly, please update it using the new headers as a reference. Supported languages: en (English), es (Neutral Spanish), pt (Portuguese). | +| `notification_email_list` (optional)| Array| ``` ["example@email.com", "john@example.com"] ``` | Allows adding a group of email recipients to receive a notification when a report is ready and available for download. Make sure to include the email associated with your Mercado Pago account so you also receive the notifications. | +| `refund_detailed` (optional)| Boolean | true | Displays the reference code (`external_reference`) of the refund instead of the payment reference code (`external_reference`). | +| `include_withdrawal` (optional)| Boolean | true | Includes money withdrawals in the report. | +| `coupon_detailed` (optional)| Boolean | true | Includes a column to show discount coupon details. | +| `scheduled` (read_only) | Boolean | true | Informative field indicating whether there are already scheduled reports in the user's account.
- `True`: Automatic generation is enabled.
- `False`: Automatic generation is disabled. | +| `check_available_balance` (optional)| Boolean| true | Balance before and after making a withdrawal, explaining the account balance. (This setting is purely informational. It should not be considered for proof of balance and/or account balance). | +| `compensate_detail` (optional)| Boolean | true | Blocking and unblocking of money that offset each other and do not affect the final balance. Helps understand how the final report balance is made, in a chronological format (recommended setting if you have a large volume of transactions). | -The response object will have a similar structure to the following example: +You can configure your reports as needed. Below, we highlight the available API calls so you can manage the configuration of your report and, based on these settings, generate the reports. -```json -{ - "file_name_prefix": "release-report-USER_ID", - "include_withdrawal_at_end": true, - "scheduled": false, - "execute_after_withdrawal": false, - "separator": ";", - "display_timezone": "GMT-04", - "frequency": { - "hour": 0, - "type": "monthly", - "value": 1 - }, - "columns": [ - { - "key": "DATE" - }, - { - "key": "SOURCE_ID" - }, - { - "key": "EXTERNAL_REFERENCE" - } - ] -} -``` +> Have the [Glossary of the Releases Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand for reference whenever needed or to check any technical terms. -### Create your configuration +## Create a new configuration -Create your generation preferences through API to export columns, name your files and configure other settings: +Customize your reports by assigning different creation properties by running the following _curl_: [[[ ```curl @@ -151,7 +47,7 @@ curl -X POST \ -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ 'https://api.mercadopago.com/v1/account/release_report/config' \ -d '{ - "file_name_prefix": "release-USER_ID", + "file_name_prefix": "release-report-USER_ID", "include_withdrawal_at_end": true, "execute_after_withdrawal": false, "display_timezone": "GMT-04", @@ -241,9 +137,9 @@ String body = "{ \\"value\\": 1 }, \\"columns\\": [ - { \\"key\\": \\"DATE\\" }, - { \\"key\\": \\"SOURCE_ID\\" }, - { \\"key\\": \\"EXTERNAL_REFERENCE\\" }, + { \\"key\\": \\"DATE\\" }, + { \\"key\\": \\"SOURCE_ID\\" }, + { \\"key\\": \\"EXTERNAL_REFERENCE\\" }, ] }"; @@ -347,9 +243,9 @@ request(options, callback); ``` ]]] -You will receive an `HTTP STATUS 201 (Created)` in response if no error is found. +In the absence of errors, an HTTP status code `201 (Created)` will be issued. The API will respond with a JSON structure, where the properties will represent the configuration you created. -The response object will have a similar structure to the following example: +#### Response ```json { @@ -382,9 +278,9 @@ The response object will have a similar structure to the following example: } ``` -### Check the configuration +### Check settings -To check the configuration of your reports by API using these codes: +Check the current configuration of your reports by executing the following _curl_: [[[ ```curl @@ -451,7 +347,9 @@ request(options, callback); ``` ]]] -You will receive an `HTTP STATUS 200 (OK)` in response: +In the absence of errors, an `HTTP 200 (Ok)` status code will be issued. The API will respond with a JSON structure whose properties will represent the characteristics of your reports. + +#### Response ```json { @@ -459,7 +357,7 @@ You will receive an `HTTP STATUS 200 (OK)` in response: "include_withdrawal_at_end": true, "scheduled": false, "execute_after_withdrawal": false, - "separator": ",", + "separator": ";", "display_timezone": "GMT-04", "frequency": { "hour": 0, @@ -480,16 +378,15 @@ You will receive an `HTTP STATUS 200 (OK)` in response: } ``` +### Update settings -### Update configuration +Update the default settings of your reports when necessary by executing the following _curl_. > NOTE > -> Nota +> Note > ->If when updating the settings you want to edit the "Frequency" feature, and you have already enabled the automatic generation of your reports, you must follow these steps:

1. Cancel the scheduled generation of your reports, following the steps in the section Deactivate scheduling. [Deactivate](#bookmark_2._deactivation).
2. Update the settings by editing the `Frequency` feature, using the snippets available in this section.
3. Schedule again the automatic generation of the report, following the steps in the section Activate scheduling. [Activate](#bookmark_1._activation). - -When you need to update your settings, you can adjust the following attributes: +> If, when updating the configuration, you want to change the `frequency` attribute and have already activated the automatic creation of your reports, follow these steps:

1. Cancel the scheduled creation of your reports by following the steps described in the section **Disable automatic generation** in [Schedule report automatically.](#bookmark_schedule_report_automatically)
2. Update the configuration.
3. Re-enable the automatic creation of your reports by following the steps in the section **Enable automatic generation** in [Schedule report automatically.](#bookmark_schedule_report_automatically) [[[ ```curl @@ -589,9 +486,9 @@ String body = "{ \\"value\\": 1 }, \\"columns\\": [ - { \\"key\\": \\"DATE\\" }, - { \\"key\\": \\"SOURCE_ID\\" }, - { \\"key\\": \\"EXTERNAL_REFERENCE\\" }, + { \\"key\\": \\"DATE\\" }, + { \\"key\\": \\"SOURCE_ID\\" }, + { \\"key\\": \\"EXTERNAL_REFERENCE\\" }, ] }"; @@ -654,7 +551,7 @@ var headers = { var dataString = '{ "file_name_prefix": "release-report-USER_ID", "include_withdrawal_at_end": true, - "execute_after_withdrawal": false, + "execute_after_withdrawal": falsre, "display_timezone": "GMT-04", "notification_email_list": [ "example@email.com", @@ -695,9 +592,9 @@ request(options, callback); ``` ]]] -You will receive an `HTTP STATUS 200 (OK)` in response if no error is found. +In the absence of errors, an `HTTP 200 (Ok)` status code will be issued. The API will respond with a JSON structure whose properties will represent the configuration you have updated. -The response object will have a similar structure to the following example: +#### Response ```json { @@ -730,13 +627,13 @@ The response object will have a similar structure to the following example: } ``` -## Generating your reports manually +## Manually create report -Generate your reports manually by configuring three instances: creation, query, and download. +You have various resources at your disposal that will allow you to interact with your reports manually. -### 1. Creation +### Create report -Perform a POST to the API by specifying the desired start and end dates as follows: +Make a POST request to the API to manually generate a new report within a specific date range: [[[ ```curl @@ -806,8 +703,8 @@ var request = require('request'); var headers = { 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' + 'content-type': 'application/json', + 'Authorization': 'Bearer ENV_ACCESS_TOKEN' }; var dataString = '{ "begin_date": "2019-05-01T00:00:00Z", "end_date": "2019-06-01T00:00:00Z" }'; @@ -827,15 +724,16 @@ request(options, callback); ``` ]]] -You will receive an `HTTP STATUS 202 (Accepted)` in response if no error is found, and the report will be generated asynchronously. +In the absence of errors, an HTTP status code of `202 (Accepted)` will be issued. After that, your report will be generated asynchronously. You will receive, as a response, a JSON structure with relevant information regarding your creation request. ----[mlm, mla, mco, mpe, mlu, mlc]---- -An `HTTP STATUS 203 (Non-Authoritative Information)` response indicates that the request is as expected, however, it was not possible to create your report and it will be necessary to request it again with the dates indicated by the system. +An HTTP status response of `203 (Non-Authoritative Information)` indicates that the request occurred as expected; however, it was not possible to create your report, and you will need to request it again with the dates indicated in the system. ------------ -### 2. Query -Check the API according to the snippet below to see if the report creation is ready: +### Query report + +Consult the API as follows to explore the list of reports you have generated: [[[ ```curl @@ -872,7 +770,7 @@ System.out.println(connection.getInputStream()); import requests headers = { - 'accept': 'application/json', + 'accept': 'application/json', 'Authorization': 'Bearer ENV_ACCESS_TOKEN' } @@ -897,15 +795,15 @@ request(options, callback); ``` ]]] -You will receive `HTTP STATUS 200 (OK)` in response if no error is found. +In the absence of errors, an `HTTP 200 (Ok)` status code will be issued. The API will respond with a JSON Array in which you will find the list of all the reports it generated. -The response object will have a similar structure to the following example: +#### Response ```json [ { "id": 12345678, - "user_id": USER-ID, + "user_id": "USER_ID", "begin_date": "2015-05-01T00:00:00Z", "end_date": "2015-06-01T23:59:59Z", "file_name": "release-report-USER_ID-2016-01-20-131015.csv", @@ -918,9 +816,9 @@ The response object will have a similar structure to the following example: ] ``` -### 3. Download +### Download report -Using the `file_name` attribute, you can download the report from the following URL: +Using the `file_name` attribute, you can download any of your reports from the following URL: [[[ ```curl @@ -959,7 +857,6 @@ headers = { 'Authorization': 'Bearer ENV_ACCESS_TOKEN' } - response = requests.get('https://api.mercadopago.com/v1/account/release_report/:file_name', headers=headers) ``` ```node @@ -969,6 +866,7 @@ var headers = { 'Authorization': 'Bearer ENV_ACCESS_TOKEN' }; + var options = { url: 'https://api.mercadopago.com/v1/account/release_report/:file_name', headers: headers, @@ -984,9 +882,9 @@ request(options, callback); ``` ]]] -You will receive an `HTTP STATUS 200 (OK)` in response if no error is found. +In the absence of errors, an HTTP status code `200 (Ok)` will be issued. In the API response, you will have the requested report file available for download. -The response object will have a similar structure to the following example: +#### Response ```csv DATE,SOURCE_ID,EXTERNAL_REFERENCE,RECORD_TYPE,DESCRIPTION,NET_CREDIT_AMOUNT,NET_DEBIT_AMOUNT,GROSS_AMOUNT,MP_FEE_AMOUNT,FINANCING_FEE_AMOUNT,SHIPPING_FEE_AMOUNT,TAXES_AMOUNT,COUPON_AMOUNT,INSTALLMENTS,PAYMENT_METHOD @@ -998,19 +896,16 @@ DATE,SOURCE_ID,EXTERNAL_REFERENCE,RECORD_TYPE,DESCRIPTION,NET_CREDIT_AMOUNT,NET_ 2018-04-17T15:38:40.000-04:00,,,release,payment,850.00,0.00,850.00,0.00,0.00,0.00,0.00,0.00,1,account_money ``` -## Schedule your automatic reports - -Generate your reports on a scheduled basis by configuring two instances: activation and Deactivation. +## Schedule report automatically -### 1. Activation +Create your reports on a scheduled basis by configuring two instances: activation and deactivation. -Schedule the automatic generation of your report using the desired frequency in the configuration resource. +### Activate automatic generation -Keep in mind to update the *`scheduled`* attribute in the configuration to *`true`*: - -`POST /v1/account/release_report/schedule` +Schedule the automatic generation of the report using the frequency assigned during the configuration of your reports. When using this service, the `scheduled` property of your configuration will be automatically updated to `true`: [[[ + ```curl curl -X POST \ -H 'accept: application/json' \ @@ -1018,6 +913,7 @@ curl -X POST \ -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ 'https://api.mercadopago.com/v1/account/release_report/schedule' ``` + ```php 'application/json', - 'content-type' => 'application/json', + 'content-type' => 'application/json', 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' ); $response = Requests::delete('https://api.mercadopago.com/v1/account/release_report/schedule', $headers); @@ -1155,4 +1070,23 @@ function callback(error, response, body) { request(options, callback); ``` -]]] \ No newline at end of file +]]] + +In the absence of errors, an HTTP status code `200 (OK)` will be issued. The API will respond with a JSON structure in which you will find information associated with the report you deactivated. + +#### Response + +```json +{ + "id": 2787882, + "begin_date": "2019-08-15T06:00:00Z", + "created_from": "schedule", + "end_date": "2019-08-16T05:59:59Z", + "generation_date": "2019-08-16T02:00:00.000-04:00", + "last_modified": "2019-08-15T15:41:53.681-04:00", + "report_type": "release", + "retries": 0, + "status": "deleted", + "user_id": USER_ID +} +``` \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/api.es.md b/guides/additional-content/reports/released-money/api.es.md index 487d6315b6..2fd9e135a8 100644 --- a/guides/additional-content/reports/released-money/api.es.md +++ b/guides/additional-content/reports/released-money/api.es.md @@ -1,129 +1,46 @@ -# Generación por API +# Crear reporte a través de la API -Genera el reporte de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------ de forma manual las veces que quieras o prográmalo según tus necesidades de frecuencia a través de nuestra API. +Crea el Reporte de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ manualmente tantas veces como desees o prográmalo según la frecuencia deseada a través de nuestra API. -## Atributos configurables +## Configurar el Reporte de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ -Conoce los campos que puedes configurar para ajustar tus preferencias antes de empezar: +### Atributos configurables -> WARNING -> -> Atención -> -> Configurar el atributo `frequency` no implica que el reporte se genere automáticamente. La configuración aplicará solo cuando se active la programación automática. Para mayor detalle puedes dirigirte a la sección [Programa tus reportes.](#bookmark_programa_tus_reportes_automáticos) - -| Campo configurable | Descripción | -| --- | --- | -| `columns` |
Campo con el detalle de columnas a incluir en tu reporte. Encuentra todos los posibles valores en la sección de [Glosario](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary).

| -| `file_name_prefix` |
Prefijo que compone el nombre del reporte una vez generado y listo para descargar.

| -| `frequency` |
Indica la frecuencia diaria, semanal o mensual de los reportes programados.

- `frequency` aplica type *monthly* al día del mes o *weekly* el día de la semana
- `hour` hora del día en la que generar el reporte
- `type` indica el tipo de frecuencia *daily* (diaria), *weekly* (semanal) y *monthly* (mensual).

| -| `sftp_info` (opcional) |
Indica los datos de subida a SFTP cuando lo necesites.

| -| `separator` (opcional) |
Separador que puedes usar en el archivo .csv cuando no quieras que el separador sea una coma.

| -| `display_timezone` (opcional) |
Este campo determina la fecha y la hora que se visualiza en los reportes. Si no configuras este campo con una zona horaria, el sistema tomará por defecto el valor GMT-04. Si eliges una zona horaria que utiliza horario de verano, es necesario que hagas el ajuste manual cuando cambie la hora.

| -| `report_translation` (opcional) |
Permite cambiar el idioma predeterminado de los encabezados de las columnas. En caso de habilitarlo, se recomienda verificar que funcionen correctamente las integraciones con archivos de Excel (.xlsx) que permiten conciliar de forma automática.

Si la integración no funciona bien, asegúrate de actualizarla tomando como referencia los nuevos encabezados.

| -| `notification_email_list` (opcional) |
Permite agregar un grupo de destinatarios de correo electrónico para que reciban una notificación cuando un reporte está listo y disponible para descargar. Asegúrate de incluir el correo asociado a tu cuenta de Mercado Pago para que también recibas las notificaciones.

| -| `refund_detailed` (opcional) |
Muestra el código de referencia (external_reference) del reembolso en vez del código de referencia (external_reference) del pago.

| -| `include_withdrawal` (opcional) |
Incluye los retiros de dinero en el reporte.

| -| `coupon_detailed` (opcional) |
Suma una columna para mostrar el detalle de los cupones de descuento.

| -| `scheduled` (read_only) |
Campo informativo que indica si ya existen reportes programados en la cuenta de usuario. `True` la generación automática se encuentra activada.
`False` la generación automática se encuentra Desactivada.

| -| `check_available_balance` (opcional) |
Saldo antes y después de realizar un retiro de dinero que explica el balance de la cuenta. (Esta configuración es solo informativa. Debe excluirse para comprobaciones del balance y/o saldo de cuenta)

| -| `compensate_detail` (opcional) |
Bloqueos y desbloqueos de dinero que se compensan entre sí y que no afectan el saldo final. Ayuda a entender cómo se conforma el balance final del reporte, en una lectura cronológica (recomendado si tienes un volumen alto de transacciones).

| - -## Configura tus reportes - -Puedes configurar tus reportes según lo que necesites. A continuación, te mencionamos cuáles son las llamadas a la API que puedes hacer para crear, consultar y actualizar tus reportes. +Consulta los campos que puedes configurar para ajustar tus preferencias antes de empezar: -> NOTE -> -> Nota +> WARNING > -> Ten a mano el [Glosario](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) para consultar algún término técnico durante la generacion de tus reportes. - -### Consulta tu configuración - -Consulta la configuración de tus reportes por API de esta forma: - -[[[ - -```curl -curl -X GET \ - -H 'accept: application/json' \ - -H 'content-type: application/json' \ - -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ - 'https://api.mercadopago.com/v1/account/release_report/config' \ -``` - -```php - 'application/json', - 'content-type' => 'application/json', - 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' -); -$response = Requests::get('https://api.mercadopago.com/v1/account/release_report/config', $headers); -``` - -```java - URL url = new URL("https://api.mercadopago.com/v1/account/release_report/config"); - -HttpsURLConnection connection = (HttpsURLConnection) url.openConnection(); - -connection.setRequestMethod("GET"); -connection.setRequestProperty("Accept", "application/json"); -connection.setRequestProperty("Content-Type", "application/json"); -connection.setRequestProperty("Authorization", "Bearer ENV_ACCESS_TOKEN"); - -System.out.println(connection.getResponseCode()); -System.out.println(connection.getResponseMessage()); -System.out.println(connection.getInputStream()); -``` - -```python -import requests -headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -} - -response = requests.get('https://api.mercadopago.com/v1/account/release_report/config', headers=headers) -``` +> Importante +> +> Configurar el atributo `frequency` no implica que el reporte se genere automáticamente. La configuración se aplicará solo cuando se active la programación automática. Para obtener más información, consulta la sección [Programar reporte automáticamente](#bookmark_programar_reporte_automaticamente) -```node -var request = require('request'); +| Campo configurable | Tipo | Ejemplo | Descripción | +|---------------------------|------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `columns` | JSON Array | ``` [{"key": "DATE"}, {"key": "SOURCE_ID"}] ``` | Campo con los detalles de las columnas que se incluirán en tu reporte. Encuentra todos los valores posibles en la sección [Glossário](/developers/es/docs/checkout-pro/additional-content/reports/released-money/report-use). | +| `file_name_prefix` | String | "conciliation-settlement-report" | Prefijo que compone el nombre del reporte generado y listo para descargar. | +| `frequency` | JSON | ``` {"hour": 0, "type": "monthly", "value": 1} ``` | Indica la frecuencia diaria, semanal o mensual de los reportes programados.
- `frequency`: aplica type _monthly_ al día del mes o _weekly_ al día de la semana.
- `hour`: hora del día en que se debe generar el reporte.
- `type`: indica el tipo de frecuencia: _daily_ (diaria), _weekly_ (semanal) y _monthly_ (mensual). | +| `sftp_info` (opcional) | JSON | ``` {"server": "sftp.myserver.com", "password": "mypassword", "remote_dir": "/myfolder", "port": 22, "username": "myusername"} ``` | Proporciona los datos de conexión necesarios para acceder al servidor.
- `server`: URL o dirección IP (pública) del servidor.
- `password`: contraseña del usuario con el que estableceremos la conexión.
- `remote_dir`: carpeta donde depositaremos tus reportes.
- `port`: puerto utilizado para establecer la conexión.
- `username`: usuario con el que nos autenticaremos en tu servidor.
| +| `separator` (opcional) | String | ";" | Separador alternativo para archivos _csv_ cuando se desea utilizar un carácter diferente de la coma (','). | +| `display_timezone` (opcional)| String | "GMT-04" | Este campo determina la fecha y la hora mostradas en los reportes. Si no configuras una zona horaria para este campo, el sistema considerará la zona horaria GMT-04 como predeterminada. Si eliges una zona horaria que utiliza horario de verano, deberás ajustar manualmente cuando cambie la hora. | +| `report_translation` (opcional)| String | "es" | Permite cambiar el idioma predeterminado de los encabezados de las columnas. Si está activado, asegúrate de verificar si las integraciones con archivos Excel (_xlsx_) están funcionando correctamente para permitir la conciliación automática. Si la integración no funciona correctamente, actualízala utilizando los nuevos encabezados como referencia. Idiomas admitidos: en (inglés), es (español neutro), pt (portugués). | +| `notification_email_list` (opcional)| Array| ``` ["example@email.com", "john@example.com"] ``` | Permite agregar un grupo de destinatarios de correo electrónico para que reciban una notificación cuando un reporte esté listo y disponible para descargar. Asegúrate de incluir el correo electrónico asociado a tu cuenta de Mercado Pago para que también recibas las notificaciones. | +| `refund_detailed` (opcional) | Boolean | true | Muestra el código de referencia (`external_reference`) del reembolso en lugar del código de referencia (`external_reference`) del pago. | +| `include_withdrawal` (opcional)| Boolean | true | Incluye las retiradas de dinero en el reporte. | +| `coupon_detailed` (opcional)| Boolean | true | Incluye una columna para mostrar los detalles de los cupones de descuento. | +| `scheduled` (read_only) | Boolean | true | Campo informativo que indica si ya existen reportes programados en la cuenta del usuario.
- `True`: La generación automática está activada. - `False`: La generación automática está desactivada. | +| `check_available_balance` (opcional)| Boolean| true | Saldo antes y después de hacer una retirada, que explica el balance de la cuenta. (Esta configuración es meramente informativa. No debe considerarse como prueba de saldo y/o saldo de cuenta). | +| `compensate_detail` (opcional)| Boolean | true | Bloqueo y desbloqueo de dinero que se compensan entre sí y que no afectan el saldo final. Ayuda a entender cómo se realiza el balance final del reporte, en una lectura cronológica (recomendado si tienes un volumen alto de transacciones). | -var headers = { - 'accept': 'application/json', - 'content-type': 'application/json', - 'Authorization': 'Bearer ENV_ACCESS_TOKEN' -}; +Puedes configurar tus reportes según sea necesario. A continuación, destacamos las llamadas de la API disponibles para que puedas gestionar la configuración de tu reporte y, posteriormente, en función de esas configuraciones, generar los reportes. -var options = { - url: 'https://api.mercadopago.com/v1/account/release_report/config', - headers: headers -}; -function callback(error, response, body) { - if (!error && response.statusCode == 200) { - console.log(body); - } -} -request(options, callback); -``` +> Ten a mano el [Glossário del Reporte de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) para consultarlo siempre que sea necesario o para verificar algún término técnico. -]]] -Recibirás como respuesta un `HTTP STATUS 200 (Ok)` si no se encuentra ningún error. +## Crear una nueva configuración -El objeto de respuesta tendrá una estructura similar al ejemplo siguiente: - -### Crea tus configuraciones - -Crea tus preferencias de generación por API para exportar columnas, nombrar a tus archivos y configurar otros ajustes: +Personaliza tus reportes asignando diferentes propiedades de creación ejecutando el siguiente _curl_: [[[ - ```curl curl -X POST \ -H 'accept: application/json' \ @@ -157,7 +74,6 @@ curl -X POST \ ] }' ``` - ```php 'application/json', + 'content-type' => 'application/json', + 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' +); +$response = Requests::get('https://api.mercadopago.com/v1/account/release_report/config', $headers); +``` +```java + URL url = new URL("https://api.mercadopago.com/v1/account/release_report/config"); + +HttpsURLConnection connection = (HttpsURLConnection) url.openConnection(); + +connection.setRequestMethod("GET"); +connection.setRequestProperty("Accept", "application/json"); +connection.setRequestProperty("Content-Type", "application/json"); +connection.setRequestProperty("Authorization", "Bearer ENV_ACCESS_TOKEN"); + +System.out.println(connection.getResponseCode()); +System.out.println(connection.getResponseMessage()); +System.out.println(connection.getInputStream()); +``` +```python +import requests +headers = { + 'accept': 'application/json', + 'content-type': 'application/json', + 'Authorization': 'Bearer ENV_ACCESS_TOKEN' +} + +response = requests.get('https://api.mercadopago.com/v1/account/release_report/config', headers=headers) +``` +```node +var request = require('request'); + +var headers = { + 'accept': 'application/json', + 'content-type': 'application/json', + 'Authorization': 'Bearer ENV_ACCESS_TOKEN' +}; + +var options = { + url: 'https://api.mercadopago.com/v1/account/release_report/config', + headers: headers +}; +function callback(error, response, body) { + if (!error && response.statusCode == 200) { + console.log(body); + } +} +request(options, callback); +``` +]]] + +En ausencia de errores, se emitirá un código de estado `HTTP 200 (Ok)`. El API responderá con una estructura JSON cuyas propiedades representarán las características de tus reportes. + +#### Respuesta + +```json +{ + "file_name_prefix": "release-report-USER_ID", + "include_withdrawal_at_end": true, + "scheduled": false, + "execute_after_withdrawal": false, + "separator": ";", + "display_timezone": "GMT-04", + "frequency": { + "hour": 0, + "type": "monthly", + "value": 1 + }, + "columns": [ + { + "key": "DATE" + }, + { + "key": "SOURCE_ID" + }, + { + "key": "EXTERNAL_REFERENCE" + } + ] +} +``` + +### Actualizar configuraciones + +Actualiza las configuraciones predeterminadas de tus reportes cuando sea necesario ejecutando el _curl_ a continuación. > NOTE > > Nota > ->Si en la actualización de la configuración deseas modificar el atributo `frequency`, y ya tienes habilitada la generación automática de tus reportes, debes seguir estos pasos:

1. Cancelar la generación programada de tus reportes, siguiendo los pasos de la sección [Desactivación](#bookmark_2._desactivación).
2. Realizar la actualización de la configuración modificando el atributo `frequency`, mediante los snippets dispuestos en esta sección.
3. Programar nuevamente la generación automática del reporte, siguiendo los pasos de la sección [Activación](#bookmark_1._activación). - -Cuando necesites actualizar tu configuración, puedes ajustar los siguientes atributos: +> Si, al actualizar la configuración, deseas cambiar el atributo `frequency` y ya has activado la creación automática de tus reporte, sigue los siguientes pasos:

1. Cancela la creación programada de tus reportes siguiendo los pasos descritos en la sección **Desactivar creación automática** en [Programar reporte automáticamente.](#bookmark_programar_reporte_automaticamente)
2. Actualiza la configuración.
3. Vuelve a habilitar la creación automática de tus reportes siguiendo los pasos de la sección **Activar creación automática** en [Programar reporte automáticamente.](#bookmark_programar_reporte_automaticamente) [[[ - ```curl curl -X PUT \ -H 'accept: application/json' \ @@ -412,7 +423,6 @@ curl -X PUT \ ] }' ``` - ```php 'application/json', - 'content-type' => 'application/json', + 'content-type' => 'application/json', 'Authorization' => 'Bearer ENV_ACCESS_TOKEN' ); $response = Requests::delete('https://api.mercadopago.com/v1/account/release_report/schedule', $headers); ``` - ```java URL url = new URL("https://api.mercadopago.com/v1/account/release_report/schedule"); @@ -1059,7 +1035,6 @@ System.out.println(connection.getResponseCode()); System.out.println(connection.getResponseMessage()); System.out.println(connection.getInputStream()); ``` - ```python import requests @@ -1071,7 +1046,6 @@ headers = { response = requests.delete('https://api.mercadopago.com/v1/account/release_report/schedule', headers=headers) ``` - ```node var request = require('request'); @@ -1095,12 +1069,11 @@ function callback(error, response, body) { request(options, callback); ``` - ]]] -Recibirás como respuesta un `HTTP STATUS 200 (Ok)` si no se encuentra ningún error para cancelar. +En ausencia de errores, se emitirá un código de estado `HTTP 200 (Ok)`. El API responderá con una estructura JSON en la cual encontrarás información asociada al reporte que has desactivado. -La respuesta con los datos de la cancelación tendrá una estructura similar al ejemplo siguiente: +#### Respuesta ```json { diff --git a/guides/additional-content/reports/released-money/generate.en.md b/guides/additional-content/reports/released-money/generate.en.md index 720b4963a9..c28c4fd778 100644 --- a/guides/additional-content/reports/released-money/generate.en.md +++ b/guides/additional-content/reports/released-money/generate.en.md @@ -1,84 +1,78 @@ -# How to generate your Releases report? +# Generate report + +You can generate a report of Releases through your Mercado Pago account or via API integration. Refer to the table below for more information. ----[mla]---- > NOTE > -> Easily keep track of your sales made with a QR Code -> -> We have created new columns that allow you to identify which digital wallets or banks your clients use when they pay with a Mercado Pago QR Code. Update your settings preferences [from the panel](https://www.mercadopago[FAKER][URL][DOMAIN]/balance/reports/release/settings) or [via API](/developers/en/guides/additional-content/reports/released-money/api) so that you can include these columns in your reports. - ------------- -----[mco, mlc]---- -> WARNING -> -> Important +> Manage your sales with QR code easily > -> The reports you generate from June onwards will show your movements in chronological order so that you can identify more easily when they took place. [Learn how to use this report.](https://www.mercadopago[FAKER][URL][DOMAIN]/balance/reports/release/settings) +> We've created new columns that allow you to identify the digital wallets or banks your customers use when paying with a Mercado Pago QR code. Update your configuration preferences [in the panel](https://www.mercadopago[FAKER][URL][DOMAIN]/balance/reports/release/settings) or [via API](/developers/en/guides/additional-content/reports/released-money/api) to include these columns in your reports. ------------ -## Generating channels +## Generation channels -You can generate a Release report from your Mercado Pago account: +You can generate a report of Releases through your Mercado Pago account: -| Channels | Description | -| --- | --- | -| Mercado Pago panel | To manually generate the report from your Mercado Pago panel, go to [Reports](https://www.mercadopago[FAKER][URL][DOMAIN]/movements) and choose "Created reports".

Follow the step by step to [generate reports from your panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/panel).| -| API integration |
Schedule the frequency of your report according to your needs. It can be both manually and on a scheduled basis.

Read the documentation to [generate reports through API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/api).| +| Channels | Description | +|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Mercado Pago Panel | Manually create the report through the Mercado Pago panel. Access the [Sales and Billing](https://www.mercadopago.com.br/movements) section, click **Go to Payment and Account Statement Reports**, and select the report. For more information, read the documentation [Generate report through the panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/panel). | +| API Integration | Create the report manually or scheduled according to the desired frequency using our API integration. For more information, refer to the documentation [Generate report via API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/api). | -## Technical characteristics of the report +## Technical features of the report -Consider the following technical information when you want to generate, schedule and set up your reports +Consider the following technical information whenever you create, schedule, or configure a report. ### Report structure -Know the characteristics of the elements that make up your report. +Understand the characteristics of the elements that compose your report. -| Element or action | Characteristics | +| Actions and components | Characteristics | | --- | --- | -| Tables Detail | The detail of the tables includes information generated in at least 1 day. | -| Column Order | Fix | -| Maximum Period | Reports with data of up to 60 days. | -| Currency | Local (based on the country where the Mercado Pago account is registered) | -| Time zone of the columns |
GMT-4

Take as reference the place where you download the report from. | -| Date selection via web |
It must be based on the timezone of the user's account.
For example, the timezone of Sao Paulo corresponds to the user account registered in Brazil. | +| Table details | Table details comprise information for at least 1 day. | +| Column order | Fixed | +| Maximum period | Reports with data for up to 60 days. | +| Currency | Local (based on the country where the Mercado Pago account is registered). | +| Column time zone: | GMT-4

Take as reference the place from where the report is downloaded. | +| Web date selection | Based on the user account's time zone.
For example, a user account registered in Brazil corresponds to the São Paulo time zone. | -### Report Export +### Report export -All the options you have available when downloading your report. +All options available when downloading your report. -| Element or action | Characteristics | +| Actions and components | Characteristics | | --- | --- | -| Filename format | When the report is scheduled or manual: "prefix-custom-created-date.csv"
Example: mystore-28-05-2019.csv | -| Download formats | .csv, .xlsx

Tip:Download the report in .csv to import the data and use it in other applications. Download it in .xlsx to read the information in the spreadsheet tables. | +| File name format | Scheduled or manual report:
"configurable-prefix-creation-date.csv"
Example: mystore-28-05-2024.csv. | +| Download formats | ._csv_, ._xlsx_

**Note**: download the report in ._csv_ to import the data and use it in other applications. Download it in ._xlsx_ to read the information in spreadsheet tables. | | File | Generated reports are saved in your Mercado Pago account. | ## Notifications ### Webhook -Webhook (also known as "web callback") is a simple method that allows an application or system to send real-time data whenever a particular event takes place, that is, it is a way to passively receive information between two systems via an HTTP POST. In the case of the reports used for reconciliation, a notification is sent to the user who has set up this service when their files are generated. +Webhook, also known as "web callback," is an efficient method to receive real-time information whenever an event occurs in an application or system. This approach allows the passive transfer of data between two systems through HTTP POST requests. Regarding reports used in reconciliation, a notification is sent to the user who has configured this service as soon as the corresponding files are generated. -| Attribute | Description | -|-----------------|------------------------------| -| transaction_id | Transaction ID | -| request_date | Request date | -| generation_date | Generation date | -| files | Available files | -| type | File format | -| url | Download link | -| name | File name | -| status | Report status | -| creation_type | Manual or scheduled creation | -| report_type | Report type | -| is_test | Determines if it is a test | -| signature | Notification signature | +| Attribute | Description | +|-----------------|-----------------------------------| +| transaction_id | Transaction ID | +| request_date | Request date | +| generation_date | Creation date | +| files | Available files | +| type | File format | +| url | Download link | +| name | File name | +| status | Report status | +| creation_type | Manual or scheduled creation | +| report_type | Report type | +| is_test | Determines if it is a test | +| signature | Webhook notification digital signature | -### Password for encryption +### Encryption password -To ensure the notification process to the system, an attribute called **_signature_** will be sent in the body of the message (payload) in order to validate that the Webhook notification originated from Mercado Pago and that it is not an imitation. +The encryption password is essential to secure the notification process to the system. In the message body (_payload_), an attribute called **_"signature"_** is sent to validate the legitimate origin of the Mercado Pago Webhook notification, avoiding possible imitations. -The **_signature_** is build up by joining the `transaction_id` with the `password for encryption` configured in the **_"Webhook Notification"_** section, plus the `generation_date` of the report. Once the values are joined, they are encrypted using the **_BCrypt_** algorithm as follows: +The creation of the **signature** occurs by combining the `transaction_id` with the `encrypted password` in the **_"Webhook Notification"_** section, along with the `generation_date` of the report. These values are then encrypted using the **_BCrypt_** algorithm as follows: `signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)` diff --git a/guides/additional-content/reports/released-money/generate.es.md b/guides/additional-content/reports/released-money/generate.es.md index 34f4ceb2ca..d859301454 100644 --- a/guides/additional-content/reports/released-money/generate.es.md +++ b/guides/additional-content/reports/released-money/generate.es.md @@ -1,4 +1,6 @@ -# ¿Cómo generar tu reporte de Liberaciones? +# Generar reporte + +Puedes generar un reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ a través de tu cuenta de Mercado Pago o mediante la integración a través de la API. Consulta la tabla a continuación para obtener más información. ----[mla]---- > NOTE @@ -16,98 +18,75 @@ > Los reportes que generes a partir de junio presentarán tus movimientos en orden cronológico, para que sea más fácil identificar cuándo se realizaron. [Conoce cómo usar este reporte.](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/docs/subscriptions/additional-content/reports/released-money/how-to-use) ------------ - ## Canales de generación -Puedes generar un reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ desde tu cuenta de Mercado Pago: +Puedes generar un reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ a través de tu cuenta de Mercado Pago: -| Canales | Descripción | -| --- | --- | -| Panel de Mercado Pago | Para generar manualmente un reporte desde tu panel de Mercado Pago, ve a ----[mla, mlm]---- [Informes y facturación](https://www.mercadopago[FAKER][URL][DOMAIN]/movements), luego haz clic en *Ir a Reportes de tus cobros y estados de cuenta* y elige el reporte que deseas. ------------ ----[mlb, mpe, mlu, mco]---- [Reportes](https://www.mercadopago[FAKER][URL][DOMAIN]/movements) y elige la opción de *Ver reportes creados*. ------------

Sigue el paso a paso para [generar reportes desde el panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/panel). | -| Integración vía API | Para generar manualmente un reporte o programar la frecuencia de uno según tus necesidades, utiliza nuestra integración vía API.

Lee la documentación para [generar reportes por API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/api). | +| Canales | Descripción | +|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Panel de Mercado Pago | Es posible crear el reporte manualmente a través del panel de Mercado Pago. Accede a la sección de [Informes y facturación](https://www.mercadopago.com.ar/movements), haz clic en **Ir a reportes de pagos y extractos de cuenta** y selecciona el reporte. Para obtener más información, consulta la documentación [Generar informe desde el panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/panel). | +| Integración vía API | Crea el reporte manualmente o programa su generación según la frecuencia deseada utilizando nuestra integración a través de la API. Para obtener más información, consulta la documentación [Generar informe a través de la API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/api). | ## Características técnicas del reporte -Ten en cuenta la siguiente información técnica cuando quieras generar tus reportes. +Ten en cuenta la siguiente información técnica siempre que estés creando, programando o configurando un reporte. ### Estructura del reporte -Conoce las características de los elementos que conforman tu reporte. +Comprende las características de los elementos que componen tu informe. | Elemento o acción | Características | | --- | --- | -| Detalle de tablas | El detalle de las tablas comprende información generada en día 1 como mínimo. | -| Orden de columnas | Fijo | +| Detalles de las tablas | El detalle de las tablas comprende información generada en día 1 como mínimo. | +| Orden de las columnas | Fija | | Período máximo | Reportes con datos de hasta 60 días. | -| Moneda | Local (basada en el país donde esté registrada la cuenta de Mercado Pago) | +| Moneda | Local (según el país donde esté registrada la cuenta de Mercado Pago). | | Zona horaria de las columnas con fechas | GMT-4

Toma como referencia el lugar desde el que se descarga el reporte. | -| Selección de fechas vía web | Debe basarse en el timezone de la cuenta.
Por ejemplo, a la cuenta registrada en Brasil le corresponde el timezone de São Paulo. | +| Selección de fechas vía web | Según el timezone de la cuenta.
Por ejemplo, a la cuenta registrada en Brasil le corresponde el timezone de São Paulo. | ### Exportación del reporte -Considera estas opciones a la hora de descargar tu reporte: +Todas las opciones disponibles al descargar tu reporte. | Elemento o acción | Características | | --- | --- | -| Formato del nombre del archivo | Cuando el reporte es programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2019.csv | -| Formatos de descarga | .csv, .xlsx

Tip: descarga el reporte en .csv para importar los datos y usarlos en otras aplicaciones. Descárgalo en .xlsx para leer la información en las tablas de la hoja de cálculo. | -| Archivo | Los reportes generados quedan guardados en tu cuenta de Mercado Pago. | +| Formato del nombre del archivo | Informe programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2024.csv. | +| Formatos de descarga | ._csv_, ._xlsx_

**Nota**: descarga el reporte en formato ._csv_ para importar los datos y usarlos en otras aplicaciones. Descárgalo en formato ._xlsx_ para leer la información en tablas de hojas de cálculo. | +| Archivo | Los informes generados se guardan en tu cuenta de Mercado Pago. | ## Notificaciones ### Webhook -Webhook (también conocido como devolución de llamada web) es un método simple que facilita que una aplicación o sistema proporcione información en tiempo real cada vez que ocurre un evento, es decir, es una forma de recibir datos pasivamente entre dos sistemas a través de un HTTP POST. Para el caso de los reportes que se utilizan para conciliar se enviará una notificación al usuario que tenga configurado este servicio cuando sus archivos sean generados. - -| Atributo | Descripción | -|-----------------|------------------------------| -| transaction_id | ID de la transacción | -| request_date | Fecha de la solicitud | -| generation_date | Fecha de la generación | -| files | Archivos disponibles | -| type | Formato del archivo | -| url | Enlace de descarga | -| name | Nombre del archivo | -| status | Estado del reporte | -| creation_type | Creación manual o programada | -| report_type | Tipo de reporte | -| is_test | Define si es una prueba | -| signature | Firma de la notificación | +Webhook, también conocido como "retorno de llamada web", es un método eficiente para recibir información en tiempo real cada vez que ocurre un evento en una aplicación o sistema. Este enfoque permite la transferencia pasiva de datos entre dos sistemas mediante solicitudes HTTP POST. En relación con los informes utilizados en la conciliación, se envía una notificación al usuario que haya configurado este servicio cuando sus archivos sean generados. + +| Atributo | Descripción | +|-----------------|-----------------------------------| +| `transaction_id` | ID de la transacción | +| `request_date` | Fecha de la solicitud | +| `generation_date` | Fecha de creación | +| `files` | Archivos disponibles | +| `type` | Formato del archivo | +| `url` | Enlace de descarga | +| `name` | Nombre del archivo | +| `status` | Estado del reporte | +| `creation_type` | Creación manual o programada | +| `report_type` | Tipo de reporte | +| `is_test` | Determina si es una prueba | +| `signature` | Firma digital de la notificación | ### Contraseña para cifrado -Para hacer seguro el proceso de notificación hacia el sistema se enviará en el cuerpo del mensaje (payload) un atributo llamado **_Signature_**, con el objetivo de validar que la notificación Webhook se haya originado desde Mercado Pago y no se trate de una suplantación. +La contraseña de cifrado es esencial para asegurar el proceso de notificación al sistema. En el cuerpo del mensaje (_payload_), se envía un atributo llamado **_"signature"_** para validar la origen legítima de la notificación Webhook de Mercado Pago, evitando posibles imitaciones. -El **_Signature_** se construye uniendo el `transaction_id` con la `contraseña para cifrado` configurada en la sección de **_Notificación por Webhook_**, más el `generation_date` del reporte. Una vez concatenados los valores se cifran haciendo uso del algoritmo **_BCrypt_** de la siguiente manera: +La creación de la **_signature_** ocurre mediante la combinación del `transaction_id` con la `contraseña para cifrado` en la sección **_"Notificación por Webhook"_**, junto con la `generation_date` del reporte. Estos valores se cifran utilizando el algoritmo **_BCrypt_** de la siguiente manera: `signature = BCrypt(transaction_id + '-' + password_for_encryption + '-' + generation_date)` -Para validar que sea Mercado Pago quien emitió la notificación se debe usar la **_función de verificación_** que ofrece el algoritmo de **_BCrypt_** para el lenguaje deseado. +Para validar que sea Mercado Pago quien emitió la notificación, es necesario utilizar la **_función de verificación_** ofrecida por el algoritmo de **_BCrypt_** para el lenguaje deseado. -**Ejemplo Java:** +**Ejemplo en Java:** `BCrypt.checkpw(transaction_id + '-' + password_for_encryption + '-' + generation_date, payload_signature)` -----[mlm, mlb, mla]---- -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ------------ ----[mla]---- Liquidaciones ------------ ----[mlm, mlb]---- Liberaciones ------------ ----[mlm, mlb, mla]----para revisarlo cuando lo necesites o quieras consultar algún término técnico. ------------- - -----[mpe, mlu]---- -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico. - -> INFO -> -> Próximamente verás los registros de tus movimientos en orden cronológico. -> -> En los reportes que generes a partir de Diciembre vas a ver todos tus movimientos en el orden en que se realizaron para que puedas identificarlos más fácil y controlar mejor tus ventas. ------------- - -----[mco, mlc]---- -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico. - -> INFO -> -> Próximamente verás los registros de tus movimientos en orden cronológico. -> -> Los reportes que generes a partir del 27 de junio presentarán tus movimientos en orden cronológico para que puedas identificarlos más fácil y controlar mejor las finanzas de tu negocio. [Conoce la nueva anatomía del reporte.](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/lleva-el-control-de-tu-dinero-con-el-reporte-de-liberaciones) ------------- \ No newline at end of file +> Ten a mano el [Glosario del Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) para revisarlo cuando lo necesites o quieras consultar algún término técnico. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/generate.pt.md b/guides/additional-content/reports/released-money/generate.pt.md index 965ac54baa..efca4d2566 100644 --- a/guides/additional-content/reports/released-money/generate.pt.md +++ b/guides/additional-content/reports/released-money/generate.pt.md @@ -43,7 +43,7 @@ Todas as opções disponíveis na hora de baixar seu relatório. | Ações e componentes | Características | | --- | --- | -| Formato do nome do arquivo | Relatório programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2019.csv. | +| Formato do nome do arquivo | Relatório programado ou manual:
"prefixo-configuravel-data-de-criacao.csv"
Exemplo: minhaloja-28-05-2024.csv. | | Formatos de download | ._csv_, ._xlsx_

**Nota**: baixe o relatório em ._csv_ para importar os dados e usá-los em outros aplicativos. Baixe-o em ._xlsx_ para ler as informações em tabelas de planilha. | | Arquivo | Os relatórios gerados são salvos na sua conta do Mercado Pago. | diff --git a/guides/additional-content/reports/released-money/glossary.en.md b/guides/additional-content/reports/released-money/glossary.en.md index d29440c1c5..6cba39377d 100644 --- a/guides/additional-content/reports/released-money/glossary.en.md +++ b/guides/additional-content/reports/released-money/glossary.en.md @@ -19,11 +19,11 @@ If you have any doubts about the technical terms used, check the glossary below. | Name on the report column | What it means | |--------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Release date (DATE) | Release date, block or unblock, as applicable. | -| Transaction ID in Mercado Pago (SOURCE_ID) | Transaction ID in Mercado Pago (for example, a payment from an order). | -| Reference code (EXTERNAL_REFERENCE) |
This information helps to identify a transaction by its origin. The code can be:
- Order ID, through the order or shipment (if it is a cart purchase).
- Their own ID, provided by the seller, if it is an external integration
----[mla]---- - ID generated by Coelsa, an institution that processes the transfer to another account

------------ ----[mlc, mco, mlm, mlb]----
------------This field may be empty for some cases, such as invoice payments, money transfers, among others.

| +| Release date (DATE) | Transaction release date. It is the moment when this transaction impacts the available balance in the user's account. | +| Transaction ID in Mercado Pago (SOURCE_ID) | Transaction identifier in Mercado Pago's systems. Example: ID of a Payment. | +| Reference code (EXTERNAL_REFERENCE) |
This information helps to identify a transaction by its origin. The code can be:
- Order ID, through the order or shipment (if it is a cart purchase).
- Their own ID, provided by the seller, if it is an external integration. These data allow the correlation of transactions (records) between Mercado Pago and external systems
----[mla]---- - ID generated by Coelsa, an institution that processes the transfer to another account

------------ ----[mlc, mco, mlm, mlb]----
------------This field may be empty for some cases, such as invoice payments, money transfers, among others.

| | Registry type (RECORD_TYPE) |
`initial_available_balance` → Available balance of the previous period.


`release` → Money that was released from a collection.

`total` → Total net amount.

`available_balance` → Balance before and after a withdrawal or transfer, which explains the account balance.

| -| Description (DESCRIPTION) | Possible values that the field can assume:

For `release`: Payment (payment), ----[mla]---- General IIBB Tax of CABA(tax_payment_ibcf), IIBB Tax of CABA Cancellation (tax_payment_ibcf_cancel),------------ Simplified Regime 2% Exceeded Subject Tax (tax_payment_ibex), ----[mla]----IIBB of Bs As (tax_payment_iibb), IIBB Tax of Bs As Cancellation (tax_payment_iibb_cancel), ------------ Shipping fee (shipping), Money refund. Shipping fee (shipping_cancel), Tax Withholding (tax_withdholding), Tax Withholding Cancelled (tax_withdholding_cancel), (mediation),(mediation_cancel), Chargeback (chargeback), (fee_release_in_advance), Positive income (asset_management_gain), Negative returns (asset_management_loss)

----[mco, mlc, mpe, mlu, mla, mlm, mlb]---- For Balance prior to withdrawal and/or transfer `available_balance`: the field will display the prefix "pre" or "pos" to show the balance before or after a withdrawal/transfer, as appropriate, followed by the type of transaction, in this case, a cash withdrawal (payout) and, finally, the ID number of the transaction or Source ID.

Prefix + transaction name + transaction number.

Example: Pre cash withdrawal and transaction ID number (pre_payout_ID_source)

pre_payout_1948976543
pos_payout_1948976543 ------------

Definitions to be considered:

Chargeback `chargeback`: it is displayed when a chargeback associated with the referred payment is initiated or resolved.

Dispute `dispute`: appears when a mediation or complaint about the referred payment is initiated or resolved. It can happen before or after the payment has been released as available money and even withdrawn/transferred from the account.

Shipping_return fee `shipping_return`: it is displayed when a payment for expedited return is blocked or unblocked.

`shipping_refund`: amount of the shipping or shipping-related tax fee. The money from this refund will be released immediately.

Payment `payment`: payment released in any of the channels in which the customer operates.


Refund `refund`: refund associated with the referred payment.

----[mla]---- General IIBB Tax of CABA `tax_payment_ibcf`: gross income tax in Capital Federal, calculated monthly according to the transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of CABA Cancellation `tax_payment_ibcf_cancel`: cancellation of the gross income tax in Capital Federal.

Simplified Regime 2% Exceeded Subject Tax `tax_payment_ibex`: exceeded subject gross income tax, calculated monthly according to the transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of Bs As `tax_payment_iibb`: gross income tax in the province of Buenos Aires, calculated monthly according to transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of Bs As Cancellation `tax_payment_iibb_cancel`: cancellation of the gross income tax.

------------ IIBB Tax Collection `tax_payment_iibb_cre_[jurisdiction]`: collection of gross income tax - Mercado Credito, where [jurisdiction] is replaced by the name of the province where the tax is generated.
----[mla]---- Example 1: Collection of IIBB Tax Misiones - Mercado Credito (tax_payment_iibb_cre_misiones)
Example 2: IIBB Tax withholding San Luis (tax_payment_iibb_cre_san_luis) ------------
To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

General Regime Added Value Tax Collection `tax_iva`: collection of the added value tax (IVA). General Regime Added Value Tax Collection - Mercado Credito `tax_iva_cre`.

----[mla]---- Argentine credit and debit tax `tax_credit_debit`: from August 1, 2021 for legal institutions. This tax applies to all transactions with third parties, deposits and cash withdrawals.[Learn more about this tax.](https://www.mercadopago.com.ar/ayuda/20783).

------------ Tax withholding cancellation `tax_withdholding_cancel`: the cancellation of the tax withholding.



Withholding tax `tax_withdholding`: The collection of withholdings that could not be executed transactional to the associated payment. In Argentina they are only Gross Income withholdings (perceptions are debited as another transaction). In Uruguay they are VAT withholdings. In Colombia they are VAT, ICA and Source withholdings, as applicable

`tax_withdholding_cancel`: the cancellation of the tax_withdholding retention.

Tax on credits and debits on payments `tax_withholding_payer`: tax on credits and debits on payments.

Tax on credits and debits on receipts `tax_withholding_collector`: tax on credits and debits on collections.

Tax on credits and debits on withdrawals `tax_withholding_payout`: tax on credits and debits on withdrawals.

Tax on credits and debits on shipments `tax_withholding_shipping`: tax on credits and debits on shipments.

Shipping `shipping`: shipping fee for cart purchases that is not included in every payment of the cart.

Shipping_cancel `shipping_cancel`: cancellation of the shipping charge for cart purchases that is not included in every payment of the cart.

Chargeback `chargeback`: chargeback either for or against an operation.

Fee payments / Money advance `fee-release_in_advance`: Fee for advance.

Positive income `asset_management_gain`: positive income generated by the change in the value of shares purchased in the investment pool.

Negative returns `asset_management_loss`: negative return generated by the variation in the value of shares acquired in the common fund.

Restriction for fraudulent behavior `restriction`:happens when a restriction is applied for fraudulent behavior.

Debit of the installment of a loan `credit_payment`: Appears when the installment of a granted loan is charged.

Payout `payout`: withdrawal of available money in Mercado Pago.

Reserve for blocking money invested `reserve_for_embargo_invested`: blocking the money invested. This value is displayed when there is cash reserve in mutual funds.

Reserve for BPP shipping return `reserve_for_bpp_shipping_return`: reserve for returns.

Reserve for debt payment `reserve_for_debt_payment`: withheld for debt payment.

Reserve for refund `reserve_for_refund`: withheld for approved returns.

Reserve due to contest on linked account `reserve_for_cbk_cross_recovery`: withheld due to the chargeback in a linked account.

Reserve for payment `reserve_for_payment`: expenses pending confirmation.----[mlb]----

Judgment_bacen: `judgment_bacen`: judicial order from the Central Bank. The money may be frozen in the account due to ongoing litigation. It can be associated with value blockages.

Fraud `fraud`: security review.

Receivables' Lock `trava_de_recibibles`: block receivable. ------------

`digitalchange_transaction`: Transaction due to digital change. Inflows or outflows in the account. If you are a seller, it is the digital change you gave a buyer that paid in cash. If you are a buyer, it is the change you received for a purchase you paid in cash. | +| Description (DESCRIPTION) | Possible values that the field can assume:

For `release`: Payment (payment), ----[mla]---- General IIBB Tax of CABA(tax_payment_ibcf), IIBB Tax of CABA Cancellation (tax_payment_ibcf_cancel),------------ Simplified Regime 2% Exceeded Subject Tax (tax_payment_ibex), ----[mla]----IIBB of Bs As (tax_payment_iibb), IIBB Tax of Bs As Cancellation (tax_payment_iibb_cancel), ------------ Shipping fee (shipping), Money refund. Shipping fee (shipping_cancel), Tax Withholding (tax_withdholding), Tax Withholding Cancelled (tax_withdholding_cancel), (mediation),(mediation_cancel), Chargeback (chargeback), (fee_release_in_advance), Positive income (asset_management_gain), Negative returns (asset_management_loss)

----[mco, mlc, mpe, mlu, mla, mlm, mlb]---- For Balance prior to withdrawal and/or transfer `available_balance`: The field shows the prefix "pre" and "pos" to indicate the balance before or after a withdrawal or transfer, as applicable, followed by the transaction type – in this case, a money transfer (Payout), followed by the transaction identification number or Source ID.

Prefix + transaction name + transaction number.

Example: Pre cash withdrawal and transaction ID number (pre_payout_ID_source)

pre_payout_1948976543
pos_payout_1948976543 ------------

Definitions to be considered:

Chargeback `chargeback`: it is displayed when a chargeback associated with the referred payment is initiated or resolved.

Dispute `dispute`: appears when a mediation or complaint about the referred payment is initiated or resolved. It can happen before or after the payment has been released as available money and even withdrawn/transferred from the account.

Shipping_return fee `shipping_return`: it is displayed when a payment for expedited return is blocked or unblocked.

`shipping_refund`: amount of the shipping or shipping-related tax fee. The money from this refund will be released immediately.

Payment `payment`: payment released in any of the channels in which the customer operates.


Refund `refund`: refund associated with the referred payment.

----[mla]---- General IIBB Tax of CABA `tax_payment_ibcf`: gross income tax in Capital Federal, calculated monthly according to the transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of CABA Cancellation `tax_payment_ibcf_cancel`: cancellation of the gross income tax in Capital Federal.

Simplified Regime 2% Exceeded Subject Tax `tax_payment_ibex`: exceeded subject gross income tax, calculated monthly according to the transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of Bs As `tax_payment_iibb`: gross income tax in the province of Buenos Aires, calculated monthly according to transacted operations. To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

IIBB Tax of Bs As Cancellation `tax_payment_iibb_cancel`: cancellation of the gross income tax.

------------ IIBB Tax Collection `tax_payment_iibb_cre_[jurisdiction]`: collection of gross income tax - Mercado Credito, where [jurisdiction] is replaced by the name of the province where the tax is generated.
----[mla]---- Example 1: Collection of IIBB Tax Misiones - Mercado Credito (tax_payment_iibb_cre_misiones)
Example 2: IIBB Tax withholding San Luis (tax_payment_iibb_cre_san_luis) ------------
To reconcile by transaction, see the detail in the [Invoice Reports in MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

General Regime Added Value Tax Collection `tax_iva`: collection of the added value tax (IVA). General Regime Added Value Tax Collection - Mercado Credito `tax_iva_cre`.

----[mla]---- Argentine credit and debit tax `tax_credit_debit`: from August 1, 2021 for legal institutions. This tax applies to all transactions with third parties, deposits and cash withdrawals.[Learn more about this tax.](https://www.mercadopago.com.ar/ayuda/20783).

------------ Tax withholding cancellation `tax_withdholding_cancel`: the cancellation of the tax withholding.



Withholding tax `tax_withdholding`: The collection of withholdings that could not be executed transactional to the associated payment. In Argentina they are only Gross Income withholdings (perceptions are debited as another transaction). In Uruguay they are VAT withholdings. In Colombia they are VAT, ICA and Source withholdings, as applicable

`tax_withdholding_cancel`: the cancellation of the tax_withdholding retention.

Tax on credits and debits on payments `tax_withholding_payer`: tax on credits and debits on payments.

Tax on credits and debits on receipts `tax_withholding_collector`: tax on credits and debits on collections.

Tax on credits and debits on withdrawals `tax_withholding_payout`: tax on credits and debits on withdrawals.

Tax on credits and debits on shipments `tax_withholding_shipping`: tax on credits and debits on shipments.

Shipping `shipping`: shipping fee for cart purchases that is not included in every payment of the cart.

Shipping_cancel `shipping_cancel`: cancellation of the shipping charge for cart purchases that is not included in every payment of the cart.

Chargeback `chargeback`: chargeback either for or against an operation.

Fee payments / Money advance `fee-release_in_advance`: Fee for advance.

Positive income `asset_management_gain`: positive income generated by the change in the value of shares purchased in the investment pool.

Negative returns `asset_management_loss`: negative return generated by the variation in the value of shares acquired in the common fund.

Restriction for fraudulent behavior `restriction`:happens when a restriction is applied for fraudulent behavior.

Debit of the installment of a loan `credit_payment`: Appears when the installment of a granted loan is charged.

Payout `payout`: withdrawal of available money in Mercado Pago.

Reserve for blocking money invested `reserve_for_embargo_invested`: blocking the money invested. This value is displayed when there is cash reserve in mutual funds.

Reserve for BPP shipping return `reserve_for_bpp_shipping_return`: reserve for returns.

Reserve for debt payment `reserve_for_debt_payment`: withheld for debt payment.

Reserve for refund `reserve_for_refund`: withheld for approved returns.

Reserve due to contest on linked account `reserve_for_cbk_cross_recovery`: withheld due to the chargeback in a linked account.

Reserve for payment `reserve_for_payment`: expenses pending confirmation.----[mlb]----

Judgment_bacen: `judgment_bacen`: judicial order from the Central Bank. The money may be frozen in the account due to ongoing litigation. It can be associated with value blockages.

Fraud `fraud`: security review.

Receivables' Lock `trava_de_recibibles`: block receivable. ------------

`digitalchange_transaction`: Transaction due to digital change. Inflows or outflows in the account. If you are a seller, it is the digital change you gave a buyer that paid in cash. If you are a buyer, it is the change you received for a purchase you paid in cash. | | Net debit amount (NET_DEBIT_AMOUNT) | Accredited to the amount available . | | Net credit amount (NET_CREDIT_AMOUNT) | Debited to the amount available. | | Amount received for split payment purchases (SELLER_AMOUNT) | Amount received for split purchases. | diff --git a/guides/additional-content/reports/released-money/glossary.es.md b/guides/additional-content/reports/released-money/glossary.es.md index a88888681c..8f5bde7d42 100644 --- a/guides/additional-content/reports/released-money/glossary.es.md +++ b/guides/additional-content/reports/released-money/glossary.es.md @@ -1,6 +1,6 @@ # Glosario -Lo sabemos, algunos términos son técnicos y puede que no estés familiarizado con todos ellos. ¡Usa este glosario para no perderte! +Consulta la descripción de cada campo presente en el reporte en la tabla siguiente. ----[mla, mlm]---- > WARNING @@ -27,16 +27,16 @@ Lo sabemos, algunos términos son técnicos y puede que no estés familiarizado | Nombre de la columna del reporte | Qué significa | |--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------| -| Fecha de liquidación (DATE) | Fecha de liberación, bloqueo o desbloqueo, según corresponda. | -| ID de operación en Mercado Pago (SOURCE_ID) | ID de operación en Mercado Pago (por ejemplo, el pago de una venta). | -| Código de referencia (EXTERNAL_REFERENCE) |
Este dato ayuda a identificar una operación según su origen, el código puede ser:
- ID de la venta a través de la orden o el envío (si es una compra de carrito)
- ID propio provisto por el vendedor en caso de una integración externa
----[mla]---- - ID generado por Coelsa, entidad que procesa el retiro hacia otra cuenta

------------ ----[mlc, mco, mlm, mlb]----
------------Es posible que este campo esté vacío para algunos casos como el pago de facturas o un envío de dinero, entre otros.
| +| Fecha de liquidación (DATE) | Fecha de liberación de la transacción. Es el momento en que esta transacción afecta el saldo disponible de la cuenta del usuario. | +| ID de operación en Mercado Pago (SOURCE_ID) | Identificador de la transacción dentro de los sistemas de Mercadopago. Ejemplo: ID de un Pago. | +| Código de referencia (EXTERNAL_REFERENCE) |
Este dato ayuda a identificar una operación según su origen, el código puede ser:
- ID de la venta a través de la orden o el envío (si es una compra de carrito)
- ID propio provisto por el vendedor en caso de una integración externa. Este dato permite relacionar transacciones (registros) entre Mercado Pago y sistemas externos
----[mla]---- - ID generado por Coelsa, entidad que procesa el retiro hacia otra cuenta

------------ ----[mlc, mco, mlm, mlb]----
------------Es posible que este campo esté vacío para algunos casos como el pago de facturas o un envío de dinero, entre otros.
| | Tipo de registro (RECORD_TYPE) |
`initial_available_balance` → Dinero disponible del período anterior.

`release` → Dinero de un cargo que fue liberado.

`total` → Valor líquido total.

`total` → Es el dinero que tienes disponible en tu cuenta. Se calcula como la diferencia entre el monto acreditado total y el monto debitado total.

`available_balance` → Saldo previo y posterior a un retiro de dinero, que explica el balance de la cuenta.

| -| Descripción (DESCRIPTION) | Posibles valores que puede tomar el campo:
----[mla, mlc, mco, mlm, mlb]----

------------Para dinero liquidado `release`: Pago (payment), ----[mla]---- Percepción General Impuesto a los IIBB de CABA (tax_payment_ibcf), Anulación Percepción Impuesto a los IIBB de CABA (tax_payment_ibcf_cancel), ------------ Percepción sujeto excedido Régimen Simplificado 2% (tax_payment_ibex), ----[mla]---- Percepción Impuesto a los IIBB de Bs As (tax_payment_iibb), Anulación de Percepción Impuesto a los IIBB de Bs As (tax_payment_iibb_cancel), Tarifa de envío (shipping),------------ Devolución de dinero (shipping_cancel), Retención de impuesto (tax_withdholding), Retención de impuesto cancelada (tax_withdholding_cancel), Contracargo (chargeback), fee_release_in_advance, Rendimientos positivos (asset_management_gain), Rendimientos negativos (asset_management_loss)<\br> ----[mpe, mlu, mlc, mco, mla, mlm, mlb]----

Para saldo preivo a un retiro `available_balance`: el campo mostrará el prefijo pre o pos para indicar el saldo previo o posterior a un retiro, según corresponda, seguido del tipo de operación, en este caso, un retiro de dinero (payout) y finalmente, el número de identificación de la operación o ID Source.

Prefijo + nombre de operación + número de la operación.

Ejemplo: pre_payout_ID source

pre_payout_1948976543
pos_payout_1945676549 ------------

Definiciones a tener en cuenta:

----[mla, mlb]---- contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

`shipping_refund`: monto de la devolución que se realizó por el envío o por el impuesto asociado al envío. El dinero que corresponde a esta devolución se liberará de inmediato.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

------------

----[mla]---- Devolución de dinero `refund`: devolución asociada al pago al que hace referencia.

Percepción General Impuesto a los IIBB de CABA `tax_payment_ibcf`: percepción de ingresos brutos en Capital Federal, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Anulación Percepción Impuesto a los IIBB de CABA `tax_payment_ibcf_cancel`: cancelación del impuesto de percepción de ingresos brutos en Capital Federal.

Percepción sujeto excedido Régimen Simplificado 2% `tax_payment_ibex`: percepción de ingresos brutos por sujeto excedido de régimen simplificado, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Percepción Impuesto a los IIBB de Bs As `tax_payment_iibb`: percepción de ingresos brutos en provincia de Buenos Aires, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Anulación de Percepción Impuesto a los IIBB de Bs As `tax_payment_iibb_cancel`: cancelación del impuesto de percepción de ingresos brutos.

------------ Percepción de impuesto a los IIBB `tax_payment_iibb_cre_[jurisdicción]`: percepción de impuesto a los IIBB - Mercado Crédito, en donde `[jurisdicción]` se reemplaza por el nombre de la provincia donde se te genera el impuesto.
Ejemplo 1: Percepción Impuesto a los IIBB Misiones - Mercado Crédito (tax_payment_iibb_cre_misiones)
Ejemplo 2: Percepción Impuesto a los IIBB San Luis - Mercado (tax_payment_iibb_cre_san_luis)
Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Percepción de impuesto a los IIBB y juristidiccón `tax_iibb_[jurisdicción]`: percepción de impuesto a los IIBB, en donde `[jurisdicción]` se reemplaza por el nombre de la provincia donde se te genera el impuesto.
----[mla]---- Ejemplo 1: tax_iibb_misiones
Ejemplo 2: tax_iibb_san_luis ------------
Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/)

Percepción Impuesto al Valor Agregado Régimen General `tax_iva`: percepción de Impuesto al Valor Agregado Régimen General.

percepción de Impuesto al Valor Agregado Régimen General - Mercado Crédito. `tax_iva_cre`:

----[mla]---- Impuesto sobre Créditos y Débitos que rige en Argentina `tax_credit_debit`: impuesto sobre Créditos y Débitos que rige en Argentina desde el 1 de agosto de 2021 para personas jurídicas. Este impuesto alcanza a todas las transacciones realizadas con terceros, depósitos y extracciones en efectivo. [Ver más detalle sobre este impuesto](https://www.mercadopago.com.ar/ayuda/20783).

------------ Retención de impuesto cancelada `tax_withdholding_cancel`: la cancelación de la retención tax_withdholding.

Retención de impuesto `tax_withdholding`: el cobro de retenciones que no se pudieron ejecutar transaccionales al pago asociado. En Argentina son únicamente retenciones de Ingresos Brutos (las percepciones se debitan como otra operación). En Uruguay son retenciones de IVA. En Colombia son retenciones de IVA, ICA y Fuente según aplique el caso.

Impuesto sobre los Créditos y Débitos en pagos `tax_withholding_payer`: Impuesto sobre los Créditos y Débitos en pagos.

Impuesto sobre los Créditos y Débitos en cobros `tax_withholding_collector`: impuesto sobre los Créditos y Débitos en cobros.

Impuesto sobre los Créditos y Débitos en retiros `tax_withholding_payout`: impuesto sobre los Créditos y Débitos en retiros.

Impuesto sobre los Créditos y Débitos en envíos `tax_withholding_shipping`: impuesto sobre los Créditos y Débitos en envíos.

Tarifa de envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Devolución de dinero / Tarifa de envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Rendimientos positivos `asset_management_gain`: rendimiento positivo generado por la variación del valor de cuotapartes suscritas en el fondo común de inversión.

Rendimientos negativos `asset_management_loss`: rendimiento negativo generado por la variación del valor de cuotapartes suscritas en el fondo común de inversión.

Restricción por comportamiento fraudulento `restriction`: ocurre cuando se te aplica una restricción por comportamiento fraudulento.

Débito de la cuota de un préstamo `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Extracción de efectivo `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Embargo dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Dinero retenido de envío por devolución de venta en Mercado Libre `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Dinero retenido por deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Dinero retenido para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación. ----[mlb]----

`judgment_bacen`: orden Judicial del Banco Central. El dinero puede estar congelado en la cuenta por algún litigio en curso. Puede estar asociado a bloqueos por monto.

Revisión de seguridad `fraud`: revisión de seguridad.------------ ----[mco, mlu]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

`shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

`credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

`payment`: pago que se libera en alguno de los canales en los que opera el cliente.

`withdrawal`: retiro que se ejecuta sobre el dinero disponible.

`refund`: devolución asociada al pago al que hace referencia.

`shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

`mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

`fee-release_in_advance`: comisión por adelanto.

`tax_withdholding`: el cobro de retenciones que no se pudieron ejecutar transaccionales al pago asociado. En Argentina son únicamente retenciones de Ingresos Brutos (las percepciones se debitan como otra operación). En Uruguay son retenciones de IVA. En Colombia son retenciones de IVA, ICA y Fuente según aplique el caso.

`tax_withdholding_cancel`: la cancelación de la retención tax_withdholding.

`tax_withholding_payer`: Impuesto sobre los Créditos y Débitos en pagos.

`tax_withholding_collector`: Impuesto sobre los Créditos y Débitos en cobros.

Impuesto sobre los Créditos y Débitos en retiros `tax_withholding_payout`: Impuesto sobre los Créditos y Débitos en retiros.

Extracción de efectivo `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

embargo de tu dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Dinero retenido de envío por devolución de venta en Mercado Libre `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Dinero retenido por deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Dinero retenido para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación. ------------ ----[mlm]----

Contracargos `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Transferencia `withdrawal`: retiro que se ejecuta sobre el dinero disponible.

`refund`: devolución asociada al pago al que hace referencia.

`shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Contracargo `chargeback`: contracargo ya sea a favor o en contra de una operación.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.------------ ----[mlc]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Contracargo / Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Transferencia `withdrawal`: retiro que se ejecuta sobre el dinero disponible.

Devolución de dinero `refund`: devolución asociada al pago al que hace referencia.

Envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Devolución de dinero por envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Reserva para devoluciones `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Retenido para cobro de deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Retenido para devoluciones `reserve_for_refund`: retenido para devoluciones.

Retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación.------------ ----[mpe]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

devolución de dinero de envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Reserva para devolución en envío BBP `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Reserva para pago de deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Reserva para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Reserva para pago `reserve_for_payment`: consumos pendientes de confirmación.------------ ----[mlb]----

`judgment_bacen`: orden judicial del Banco Central. Es posible que el dinero se congele en la cuenta debido a un litigio en curso. Puede estar asociado con cantidades bloqueadas.

`fraud`: revisión de seguridad.

`trava_de_recibibles`: bloqueo por cobrar. ------------ ----[mla]----

`tip`: Monto que corresponde a la propina que se pagó a través de un código QR. ------------

`digitalchange_transaction`: Movimiento por Vueltos digitales. Ingreso o salida de dinero en cuenta. Si eres vendedor, corresponde a los vueltos de dinero digital que le diste a un comprador que pagó en efectivo. Si eres comprador, corresponde al cambio que debiste recibir en la compra que pagaste en efectivo. | +| Descripción (DESCRIPTION) | Posibles valores que puede tomar el campo:
----[mla, mlc, mco, mlm, mlb]----

------------Para dinero liquidado `release`: Pago (payment), ----[mla]---- Percepción General Impuesto a los IIBB de CABA (tax_payment_ibcf), Anulación Percepción Impuesto a los IIBB de CABA (tax_payment_ibcf_cancel), ------------ Percepción sujeto excedido Régimen Simplificado 2% (tax_payment_ibex), ----[mla]---- Percepción Impuesto a los IIBB de Bs As (tax_payment_iibb), Anulación de Percepción Impuesto a los IIBB de Bs As (tax_payment_iibb_cancel), Tarifa de envío (shipping),------------ Devolución de dinero (shipping_cancel), Retención de impuesto (tax_withdholding), Retención de impuesto cancelada (tax_withdholding_cancel), Contracargo (chargeback), fee_release_in_advance, Rendimientos positivos (asset_management_gain), Rendimientos negativos (asset_management_loss)<\br> ----[mpe, mlu, mlc, mco, mla, mlm, mlb]----

Para saldo previo a un retiro `available_balance`: el campo mostrará el prefijo pre o pos para indicar el saldo previo o posterior a un retiro, según corresponda, seguido del tipo de operación, en este caso, un retiro de dinero (payout) y finalmente, el número de identificación de la operación o ID Source.

Prefijo + nombre de operación + número de la operación.

Ejemplo: pre_payout_ID source

pre_payout_1948976543
pos_payout_1945676549 ------------

Definiciones a tener en cuenta:

----[mla, mlb]---- contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

`shipping_refund`: monto de la devolución que se realizó por el envío o por el impuesto asociado al envío. El dinero que corresponde a esta devolución se liberará de inmediato.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

------------

----[mla]---- Devolución de dinero `refund`: devolución asociada al pago al que hace referencia.

Percepción General Impuesto a los IIBB de CABA `tax_payment_ibcf`: percepción de ingresos brutos en Capital Federal, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Anulación Percepción Impuesto a los IIBB de CABA `tax_payment_ibcf_cancel`: cancelación del impuesto de percepción de ingresos brutos en Capital Federal.

Percepción sujeto excedido Régimen Simplificado 2% `tax_payment_ibex`: percepción de ingresos brutos por sujeto excedido de régimen simplificado, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Percepción Impuesto a los IIBB de Bs As `tax_payment_iibb`: percepción de ingresos brutos en provincia de Buenos Aires, se calcula una vez por mes de acuerdo a las operaciones transaccionadas. Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion).

Anulación de Percepción Impuesto a los IIBB de Bs As `tax_payment_iibb_cancel`: cancelación del impuesto de percepción de ingresos brutos.

------------ Percepción de impuesto a los IIBB `tax_payment_iibb_cre_[jurisdicción]`: percepción de impuesto a los IIBB - Mercado Crédito, en donde `[jurisdicción]` se reemplaza por el nombre de la provincia donde se te genera el impuesto.
Ejemplo 1: Percepción Impuesto a los IIBB Misiones - Mercado Crédito (tax_payment_iibb_cre_misiones)
Ejemplo 2: Percepción Impuesto a los IIBB San Luis - Mercado (tax_payment_iibb_cre_san_luis)
Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/).

Percepción de impuesto a los IIBB y juristidiccón `tax_iibb_[jurisdicción]`: percepción de impuesto a los IIBB, en donde `[jurisdicción]` se reemplaza por el nombre de la provincia donde se te genera el impuesto.
----[mla]---- Ejemplo 1: tax_iibb_misiones
Ejemplo 2: tax_iibb_san_luis ------------
Para conciliar por operación, ver el detalle en los [Informes de Facturas en MyML](https://vendedores.mercadolibre[FAKER][URL][DOMAIN]/blog/notas/todo-lo-que-tenes-que-saber-sobre-tu-facturacion/)

Percepción Impuesto al Valor Agregado Régimen General `tax_iva`: percepción de Impuesto al Valor Agregado Régimen General.

percepción de Impuesto al Valor Agregado Régimen General - Mercado Crédito. `tax_iva_cre`:

----[mla]---- Impuesto sobre Créditos y Débitos que rige en Argentina `tax_credit_debit`: impuesto sobre Créditos y Débitos que rige en Argentina desde el 1 de agosto de 2021 para personas jurídicas. Este impuesto alcanza a todas las transacciones realizadas con terceros, depósitos y extracciones en efectivo. [Ver más detalle sobre este impuesto](https://www.mercadopago.com.ar/ayuda/20783).

------------ Retención de impuesto cancelada `tax_withdholding_cancel`: la cancelación de la retención tax_withdholding.

Retención de impuesto `tax_withdholding`: el cobro de retenciones que no se pudieron ejecutar transaccionales al pago asociado. En Argentina son únicamente retenciones de Ingresos Brutos (las percepciones se debitan como otra operación). En Uruguay son retenciones de IVA. En Colombia son retenciones de IVA, ICA y Fuente según aplique el caso.

Impuesto sobre los Créditos y Débitos en pagos `tax_withholding_payer`: Impuesto sobre los Créditos y Débitos en pagos.

Impuesto sobre los Créditos y Débitos en cobros `tax_withholding_collector`: impuesto sobre los Créditos y Débitos en cobros.

Impuesto sobre los Créditos y Débitos en retiros `tax_withholding_payout`: impuesto sobre los Créditos y Débitos en retiros.

Impuesto sobre los Créditos y Débitos en envíos `tax_withholding_shipping`: impuesto sobre los Créditos y Débitos en envíos.

Tarifa de envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Devolución de dinero / Tarifa de envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Rendimientos positivos `asset_management_gain`: rendimiento positivo generado por la variación del valor de cuotapartes suscritas en el fondo común de inversión.

Rendimientos negativos `asset_management_loss`: rendimiento negativo generado por la variación del valor de cuotapartes suscritas en el fondo común de inversión.

Restricción por comportamiento fraudulento `restriction`: ocurre cuando se te aplica una restricción por comportamiento fraudulento.

Débito de la cuota de un préstamo `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Extracción de efectivo `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Embargo dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Dinero retenido de envío por devolución de venta en Mercado Libre `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Dinero retenido por deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Dinero retenido para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación. ----[mlb]----

`judgment_bacen`: orden Judicial del Banco Central. El dinero puede estar congelado en la cuenta por algún litigio en curso. Puede estar asociado a bloqueos por monto.

Revisión de seguridad `fraud`: revisión de seguridad.------------ ----[mco, mlu]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

`shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

`credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

`payment`: pago que se libera en alguno de los canales en los que opera el cliente.

`withdrawal`: retiro que se ejecuta sobre el dinero disponible.

`refund`: devolución asociada al pago al que hace referencia.

`shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

`mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

`fee-release_in_advance`: comisión por adelanto.

`tax_withdholding`: el cobro de retenciones que no se pudieron ejecutar transaccionales al pago asociado. En Argentina son únicamente retenciones de Ingresos Brutos (las percepciones se debitan como otra operación). En Uruguay son retenciones de IVA. En Colombia son retenciones de IVA, ICA y Fuente según aplique el caso.

`tax_withdholding_cancel`: la cancelación de la retención tax_withdholding.

`tax_withholding_payer`: Impuesto sobre los Créditos y Débitos en pagos.

`tax_withholding_collector`: Impuesto sobre los Créditos y Débitos en cobros.

Impuesto sobre los Créditos y Débitos en retiros `tax_withholding_payout`: Impuesto sobre los Créditos y Débitos en retiros.

Extracción de efectivo `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

embargo de tu dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Dinero retenido de envío por devolución de venta en Mercado Libre `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Dinero retenido por deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Dinero retenido para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación. ------------ ----[mlm]----

Contracargos `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Transferencia `withdrawal`: retiro que se ejecuta sobre el dinero disponible.

`refund`: devolución asociada al pago al que hace referencia.

`shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

`shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Contracargo `chargeback`: contracargo ya sea a favor o en contra de una operación.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.------------ ----[mlc]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Contracargo / Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Transferencia `withdrawal`: retiro que se ejecuta sobre el dinero disponible.

Devolución de dinero `refund`: devolución asociada al pago al que hace referencia.

Envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Devolución de dinero por envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Reserva para devoluciones `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Retenido para cobro de deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Retenido para devoluciones `reserve_for_refund`: retenido para devoluciones.

Retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Consumos pendientes de confirmación `reserve_for_payment`: consumos pendientes de confirmación.------------ ----[mpe]---- Contracargo `chargeback`: aparece cuando se inicia o resuelve un contracargo asociado al pago al que hace referencia.

Reclamo `dispute`: aparece cuando se inicia o resuelve una mediación o reclamo sobre el pago al que hace referencia. Puede ocurrir antes o después de que el pago se haya liberado como dinero disponible e incluso retirado de la cuenta.

Comisión por devolución de envío `shipping_return`: aparece cuando se bloquea o desbloquea un pago realizado por devolución express.

Pago de crédito `credit_payment`: aparece cuando se cobra la cuota de un préstamo otorgado.

Pago `payment`: pago que se libera en alguno de los canales en los que opera el cliente.

Envío `shipping`: comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

devolución de dinero de envío `shipping_cancel`: cancelación de la comisión de shipping para las compras de carrito que no se incluye en cada uno de los pagos del carrito.

Mediación `mediation`: resolución de una mediación a favor del comprador que termina restando del dinero disponible del vendedor.

Cancelación de la mediación `mediation_cancel`: cancelación de la mediación resuelta a favor del comprador.

Pago de comisiones / Adelanto de dinero `fee-release_in_advance`: comisión por adelanto.

Retiro de dinero `payout`: extracción en efectivo de dinero disponible en Mercado Pago.

Reserva para bloqueo de dinero invertido `reserve_for_embargo_invested`: embargo de tu dinero invertido. Este valor aparece cuando hay una reserva de dinero en fondos de inversión.

Reserva para devolución en envío BBP `reserve_for_bpp_shipping_return`: reserva para devoluciones.

Reserva para pago de deuda `reserve_for_debt_payment`: retenido para cobro de deuda.

Reserva para reembolso `reserve_for_refund`: retenido para devoluciones.

Dinero retenido por contracargo de cuenta vinculada `reserve_for_cbk_cross_recovery`: retenido por contracargo de cuenta vinculada.

Reserva para pago `reserve_for_payment`: consumos pendientes de confirmación.------------ ----[mlb]----

`judgment_bacen`: orden judicial del Banco Central. Es posible que el dinero se congele en la cuenta debido a un litigio en curso. Puede estar asociado con cantidades bloqueadas.

`fraud`: revisión de seguridad.

`trava_de_recibibles`: bloqueo por cobrar. ------------ ----[mla]----

`tip`: Monto que corresponde a la propina que se pagó a través de un código QR. ------------

`digitalchange_transaction`: Movimiento por Vueltos digitales. Ingreso o salida de dinero en cuenta. Si eres vendedor, corresponde a los vueltos de dinero digital que le diste a un comprador que pagó en efectivo. Si eres comprador, corresponde al cambio que debiste recibir en la compra que pagaste en efectivo. | | Monto neto acreditado (NET_CREDIT_AMOUNT) | Acreditado al monto disponible. | | Monto neto debitado (NET_DEBIT_AMOUNT) | Debitado al monto disponible. | | Monto recibido por compras por split (SELLER_AMOUNT) | Monto recibido por compras por split. | | Monto bruto de la operación (GROSS_AMOUNT) | Monto de la operación bruto. | -| Datos extra (METADATA) | Datos extras como por ejemplo el ID de las devoluciones parciales o datos provistos por el vendedor en caso de tener una integración externa. ----[mlb]---- Cuando se muestra "Fee discount" se entiende como la reducción en el cargo por venta por la participación en una campaña comercial. ------------ | +| Datos extra (METADATA) | Datos extras como por ejemplo el ID de las devoluciones parciales o datos provistos por el vendedor en caso de tener una integración externa. | | MP_FEE_AMOUNT | Pago Comisión de Mercado Pago y/o Mercado Libre. ----[mla, mpe, mco, mlm, mlu, mlc]---- Incluye IVA. ------------ | | Comisión por ofrecer cuotas sin interés (FINANCING_FEE_AMOUNT) | Costo por ofrecer cuotas sin interés. | | Costo de envío (SHIPPING_FEE_AMOUNT)| Costo de envío. | diff --git a/guides/additional-content/reports/released-money/how-to-use.en.md b/guides/additional-content/reports/released-money/how-to-use.en.md index 739a3f0b27..bfe311018d 100644 --- a/guides/additional-content/reports/released-money/how-to-use.en.md +++ b/guides/additional-content/reports/released-money/how-to-use.en.md @@ -1,84 +1,51 @@ -# How to use the report? +# Report uses -Once the report is ready and downloaded, you will have a file to review the spreadsheets or import into the reconciliation program you use. +Once the report is ready and downloaded, you will have a file ready to consult spreadsheets and import them into the program you use. -To review the report we recommend downloading it in .csv format to open it in the program that you view it. Configure your program to support the UTF-8 format, so you avoid reading problems. +To review the report, we recommend downloading it in CSV format to open it in a program that can visualize it. The file should be configured in UTF-8 format to avoid reading issues. -## What does the report contain? +## Report content -The report is composed by: - -| Report composition | Description | +| Report field | Description | | --- | --- | -| Initial Available Balance |
Initial balance.

| -| Release |
The detail of the money releases that includes the initial balance.

| +| Initial Available Balance |
Initial balance. Indicates the amount available on the initial date of the period you selected for reconciliation.

| +| Release |
Details of releases of money, including the initial balance and transactions impacting the total balance.

| | Block |
Money blocks due to disputes.

| -| Unblock |
Unlocks for the resolution of disputes.

| -| Subtotal |
The sum of the operations that make up each section.

| -| Total|
It is the final result composed of the sum of all subtotals.

That is to say:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = total result

| - -In addition, the report reflects the accounting concepts of *owe* (money you must pay) and *will have* (money you must collect) in two columns, one for each concept: +| Unblock |
Unblocks after dispute resolution.

| +| Subtotal |
Sum of transactions within each section.

| +| Total|
Final result composed of the sum of all subtotals.

In other words:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = total result.

It is the difference between the total credited net amount and the total debited net amount. | +Additionally, the report reflects accounting concepts of debit (money you need to pay) and credit (money you are due to receive), organizing the report into two columns, one for each concept: -> Your **will have** will be seen in the `NET_CREDIT` column. +> Your **credit** will be in the `NET_CREDIT_AMOUNT` column. >
-> Your **owe** will be seen in the `NET_DEBIT` column. +> Your **debt** will be in the `NET_DEBIT_AMOUNT` column. -You will see the available balance from the released transactions in the `NET_CREDIT` (credited) and `NET_DEBIT` (debited) columns, depending on whether the amount is positive or negative. You will also see there the gross amount and the financing costs, taxes and shipping costs that we deducted to reach the net amount. +The available balances of transactions are displayed in the `NET_CREDIT` (credit) and `NET_DEBIT` (debit) columns according to positive or negative values. In these fields, the gross amount and discounts related to financing, taxes, and shipping costs are also detailed, resulting in the final net amount. -**What happens if a transfer fails?** - -If this happens, the report is still valid. The money returns to your account and the transaction will appear in the report as a new line in the `NET_CREDIT` column. +If a transfer is not completed, the report remains valid. The amount will be refunded to your account, and the transaction will be displayed on a new line in the `NET_CREDIT` column. > NOTE > -> Note +> Important > -> Have the [Glossary of Releases report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand to review it when needed or want to review a technical term. +> Have the [Release Report Glossary](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/released-money/glossary) on hand to consult when needed to check any technical term. ## Report example -Note how the Release report is composed in this example to identify the sections and read your own reports: - -![Mercado Pago Release report example](/images/manage-account/reports/example-release-en.jpg) +Observe what comprises the Release Report in the following example to identify the sections and analyze your own reports: +----[mla]---- +![Reporte de liquidaciones](/images/manage-account/reports/example-release-es.jpg) -The default version will show an extended view of the columns. The final report will have as much detail as possible. - -----[mpe]---- -## How do I analyze the reports generated from January 2022 onwards? ------------- -----[mlu]---- -## How do I analyze the reports generated from March 2022 onwards? -----[mlc, mco]---- -## How do I analyze the reports generated from August 2022 onwards? ------------- -----[mla, mlm]---- -## How do I analyze the reports generated from October 2022 onwards? ------------ -----[mlb]---- -## How do I analyze the reports generated from January 2023 onwards? ------------- -----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- -The reports generated as of ------------ ----[mpe]----January 2022------------ ----[mlu]----March 2022------------ ----[mla, mlm]----October 2022------------ ----[mco, mlc]----August 2022------------ ----[mlb]----January 2023------------ ----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- have the following characteristics: - -1. The movements are displayed in chronological order, which allows you to identify them more easily and better control your orders. -2. If there is a complaint or chargeback due to a problem with the service or the product provided, the respective amount is withheld until the mediation is resolved. This information is included in your report and you can find it by searching for the prefix "reserve-". -3. The movements related to the money withdrawals and/or transfers from your available money are displayed as "Payout", and all the mediations that may arise when a complaint is initiated or resolved are shown as "Dispute". You can review this glossary to check the description of all the other movements and terms. - -## What information is in the report? - -The report has a simplified structure to make it easier to understand it: +----[mlm, mlb, mlc, mco, mlu, mpe]---- +![Reporte de liberaciones](/images/manage-account/reports/example-release-es.jpg) -| Report Composition | Description | -| --- | --- | -| Initial Available Balance |
Initial balance. Indicates the amount that was available on the initial date of the period you selected to make the reconciliation.

| -| Release |
The detail of the transactions that impact the total balance.

| -| Total|
It is the difference between the total net amount credited and the total net amount debited.

| - -## Example of a report +------------ +The default version will show an extended view of the columns. The final report will have the most detailed information possible. -Check in this example how the report "Releases" is composed to identify the sections and analyze your own reports: +## Report organization -![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-en.jpg) +See the following example for the organization of the report: ------------- \ No newline at end of file +![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-es.jpg) \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/how-to-use.es.md b/guides/additional-content/reports/released-money/how-to-use.es.md index 93824a825f..f419728e23 100644 --- a/guides/additional-content/reports/released-money/how-to-use.es.md +++ b/guides/additional-content/reports/released-money/how-to-use.es.md @@ -1,49 +1,39 @@ -# ¿Cómo usar el reporte? +# Usos del reporte -Una vez listo y descargado el reporte, tendrás un archivo para consultar las planillas de cálculo o importar en el programa de conciliación que uses. +Una vez que el reporte esté listo y descargado, tendrás un archivo preparado para consultar las planillas de cálculo e importarlas al programa de conciliación que utilices. -Para consultar el reporte te recomendamos descargarlo en formato .csv y abrirlo en una hoja de cálculos o cualquier programa de visualización. Configura tu programa para que soporte el formato UTF-8, así evitas problemas de lectura. +Para consultar el reporte, recomendamos descargarlo en formato .csv y abrirlo en una hoja de cálculos o cualquier programa de visualización. Configura tu programa para que soporte el formato UTF-8, así evitas problemas de lectura. -## ¿Qué contiene el reporte? +## Contenido del reporte -El reporte está compuesto por: - -| Composición del reporte | Descripción | +| Campo del informe | Descripción | | --- | --- | -| Initial Available Balance |
Balance inicial.

| -| Release |
El detalle de las ----[mla]---- liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberaciones ------------ de dinero que incluye el balance inicial.

| -| Block |
Los bloqueos de dinero por disputas.

| -| Unblock |
Los desbloqueos por la resolución de las disputas.

| -| Subtotal |
Es la suma de las operaciones que componen a cada sección.

| -| Total|
Es el resultado final compuesto por la suma de todos los subtotales.

Es decir:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = resultado total

| +| Initial Available Balance |
Saldo inicial. Indica el valor que estaba disponible en la fecha inicial del período seleccionado para la conciliación.

| +| Release |
Detalle de las ----[mla]---- liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberaciones ------------ de dinero que incluyen el saldo inicial y las transacciones que impactan el saldo total.

| +| Block |
Bloqueos de dinero por disputas.

| +| Unblock |
Desbloqueos después de la resolución de las disputas.

| +| Subtotal |
Suma de las transacciones que componen cada sección.

| +| Total|
Resultado final compuesto por la suma de todos los subtotales.

Es decir:
subtotal `Release` + subtotal `Block` + subtotal `Unblock` = resultado total.

Es la diferencia entre el valor neto total acreditado y el valor neto total debitado. | -Además el reporte refleja los conceptos contables del *debe* (dinero que tienes que pagar) y *haber* (dinero que tienes por cobrar) escribiendo el reporte en dos columnas, una por cada concepto: +Además, el reporte refleja los conceptos contables del debe (dinero que debes pagar) y haber (dinero que debes cobrar), organizando el reporte en dos columnas, una para cada concepto: -> Tu **haber** lo verás en la columna `NET_CREDIT` +> Tu **haber** estará en la columna `NET_CREDIT_AMOUNT`. >
-> Tu **debe** estará en la columna `NET_DEBIT` - -Verás el dinero disponible de las operaciones liquidadas en las columnas `NET_CREDIT` (acreditado) y `NET_DEBIT` (debitado), dependiendo de si el monto es positivo o negativo. También verás ahí el monto bruto y los gastos de financiamiento, impuestos y costos de envío que descontamos para llegar al monto neto. +> Tu **debe** estará en la columna `NET_DEBIT_AMOUNT`. -**¿Qué pasa si una transferencia falla?** +Los saldos disponibles de las transacciones liquidadas se muestran en las columnas `NET_CREDIT_AMOUNT` (acreditado) y `NET_DEBIT_AMOUNT` (debitado) dependiendo de si el monto es positivo o negativo. En estos campos también se detallan el monto bruto y los descuentos relacionados con financiamientos, impuestos y costos de envío, dando como resultado el valor neto final. -Si esto pasa, el reporte sigue siendo válido. El dinero vuelve a tu cuenta y la operación aparecerá en el reporte como una nueva línea en la columna `NET_CREDIT`. +Si esto pasa, el reporte sigue siendo válido. El dinero vuelve a tu cuenta y la operación aparecerá en el reporte como una nueva línea en la columna `NET_CREDIT_AMOUNT`. -----[mlm, mlb, mlc, mco, mla]---- -> NOTE +> NOTA > -> Nota +> Importante > -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ------------ ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco]---- Liberaciones ------------ ----[mlm, mlb, mlc, mco, mla]---- para revisarlo cuando lo necesites o quieras consultar algún término técnico.------------ - -----[mpe, mlu]---- -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico. ------------- +> Ten a mano el [Glosario del Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](/developers/es/guides/additional-content/reports/released-money/glossary) para consultarlo cuando necesites revisar algún término técnico. -## Ejemplo de un reporte - -Observa cómo está compuesto el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ en este ejemplo para identificar las secciones y leer tus propios reportes: +## Ejemplo de reporte +Observa lo que compone el Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ en el siguiente ejemplo para identificar las secciones y analizar tus propios reportes: ----[mla]---- ![Reporte de liquidaciones](/images/manage-account/reports/example-release-es.jpg) @@ -52,43 +42,10 @@ Observa cómo está compuesto el reporte de ----[mla]---- Liquidaciones -------- ![Reporte de liberaciones](/images/manage-account/reports/example-release-es.jpg) ------------ +La versión por defecto mostrará una vista extendida de las columnas. El reporte final tendrá la mayor cantidad de detalles posible. -La versión por defecto mostrará una vista extendida de las columnas. El informe final tendrá la mayor cantidad de detalle posible. - -----[mpe]---- -## ¿Cómo leer los reportes que generes a partir de enero de 2022? ------------- -----[mlu]---- -## ¿Cómo leer los reportes que generes a partir de marzo de 2022? ------------- -----[mlc, mco]---- -## ¿Cómo leer los reportes que generes a partir de agosto de 2022? ------------- -----[mla, mlm]---- -## ¿Cómo leer los reportes que generes a partir de octubre de 2022? ------------- -----[mlb]---- -## ¿Cómo leer los reportes que generes a partir de enero de 2023? ------------- -----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- -Los reportes que generes a partir de ------------ ----[mpe]----enero de 2022 ------------ ----[mlu]---- marzo de 2022 ------------ ----[mla, mlm]----octubre de 2022------------ ----[mco, mlc]----agosto de 2022 ------------ ----[mlb]----enero de 2023 ------------ ----[mpe, mlu, mla, mlm, mlc, mco, mlb]---- tienen las siguientes características: -1. Los movimientos se presentan en el orden en que ocurrieron, con lo cual podrás identificarlos con mayor facilidad y controlar mejor tus ventas. -2. Cuando se presenta alguna reclamación o contracargo por algún problema con el servicio o producto que vendiste, tu dinero es retenido hasta que la mediación se resuelva. Esta información se visualiza en tu reporte y la reconoces porque su descripción lleva el prefijo reserve-. -3. Los movimientos relacionados con los retiros sobre tu dinero disponible se muestran como payout y todas las mediaciones que surgen cuando se inicia o resuelve un reclamo se presentan como dispute. Para conocer la descripción de otros movimientos y términos, puedes usar [este glosario](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary). - -## ¿Qué contiene el reporte? - -El reporte presenta una estructura más simple para facilitar su comprensión: - -| Composición del reporte | Descripción | -| --- | --- | -| Initial Available Balance |
Balance inicial. Indica el dinero que tenías disponible en la fecha inicial del periodo que elegiste para conciliar.

| -| Release |
El detalle de las transacciones que impactan el balance total.

| -| Total|
Es la diferencia entre el monto neto acreditado total y el monto neto debitado total.

| - -## Ejemplo de un reporte -Observa cómo está compuesto el reporte de Dinero retirado en este ejemplo para identificar las secciones y leer tus propios reportes: +## Organización del informe -![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-es.jpg) +Mira el siguiente ejemplo para entender la organización del reporte: ------------- \ No newline at end of file +![Reporte de Dinero retirado Ejemplos Mercado Pago](/images/manage-account/reports/example-nledger-es.jpg) \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.en.md b/guides/additional-content/reports/released-money/introduction.en.md index 67056c2948..eb0a98eb21 100644 --- a/guides/additional-content/reports/released-money/introduction.en.md +++ b/guides/additional-content/reports/released-money/introduction.en.md @@ -1,54 +1,58 @@ -# What is the Releases report? +# Release report -Releases report is a **downloadable report that allows you to know the liquidity of your business and to know how your available money is composed in Mercado Pago.** It contains the **detail of all funds involved in a date period,** and includes money release cases as well as blockings and unblockings. +The Releases Report is a downloadable file detailing the balance available in your Mercado Pago account. It not only displays the total available amount but also provides information on transactions conducted within a specified period, including situations like fund blocks and unblocks. -----[mlm, mla]---- -> WARNING -> -> Important -> -> In your reports for October and the coming months you will see your transactions sorted by date of creation so that you can identify them more easily. [Learn how to read your report.](https://bit.ly/3zCb1ye) +Additionally, it informs you whether your money is available or not, allowing you to request this information for a convenient date range. Keep in mind that currently, this report is only generated through your computer. + +----[mpe]---- +## Analysis of Reports from January 2022 +------------ +----[mlu]---- +## Analysis of Reports from March 2022 +----[mlc, mco]---- +## Analysis of Reports from August 2022 +------------ +----[mla, mlm]---- +## Analysis of Reports from October 2022 ------------ ----[mlb]---- -> WARNING -> -> Important -> -> The reports you generate from January 1st 2023 will show your money movements in chronological order, so you will be able to identify them more easily and better control your business finances [Learn how to use it.](https://bit.ly/3zCb1ye) +## Analysis of Reports from January 2023 ------------ -## How do I download the report? +The reports you generate from ----[mpe]----January 2022------------ ----[mlu]----March 2022------------ ----[mla, mlm]----October 2022------------ ----[mco, mlc]----August 2022------------ ----[mlb]----January 2023------------ have the following characteristics: -Keep in mind that the report generation takes a few minutes depending on how much information you want it to include. It will not always be ready instantly and, until it is, you will see the status *In preparation* on the screen. +1. Movements are shown in chronological order, making them easier to identify and providing more control over your sales. +2. In case of any complaints or disputes related to an issue with the service or product offered, the corresponding amount is held until the mediation is resolved. This information is included in your report, and you can find it by searching for the "reserve-" prefix. +3. Movements related to withdrawals and/or transfers from your available balance appear as "Payout," and all mediations that arise when a complaint is initiated or resolved appear as "Dispute." To check the description of other movements and terms, refer to [the glossary](/developers/en/docs/checkout-pro/additional-content/reports/released-money/report-use). +4. You will find a new column called "Sale detail," providing detailed information about the items sold, facilitating reconciliation and control of your sales. Each entry in this column shows the first element of the sale, followed by the grouping of other items. -Once available, it will be in your report tray and you can always download it two ways: +## Download report -* From the download link we’ll email you. -* From your Mercado Pago account, go to *Reports* and select the Release report option. +Follow this path to learn how to generate and download the Release Report: +**Reports and Billing -> Sales and Account Statements -> Release**. -### Report Values +### Create report via API -Depending on the [rates and terms](https://www.mercadopago[FAKER][URL][DOMAIN]/settings/release-options) you choose, the money you earn from an order will be released some time after the payment is credited. For this reason, the total value you see in the report will not always match your total balance or the value you see in the billing reports. +Manually create the Release Report as often as you wish or schedule it according to your frequency needs through the [API](/developers/en/docs/checkout-pro/additional-content/reports/released-money/api). -The release periods have to do with the bank terms or the intermediation flows when the operations are carried out in Mercado Libre. Other operations that may affect the release of your money are Chargebacks and Complaints that you may receive for an order. +Report generation takes a few minutes, depending on how much information you want to include. It won't always be ready instantly, and until it is, you will see the status "In preparation" on the screen. +> Refer to ["How to analyze the Release Report"](https://www.mercadopago.com.br/ajuda/28771) for a better understanding of your report. -> To know the exact date on which the money of an operation will be available, check the [details of your accredited collections](https://www.mercadopago[FAKER][URL][DOMAIN]/activities/balance). +### Report values -## What to use the report for +Depending on the [selected fees and deadlines](https://www.mercadopago.com.br/settings/release-options), the value obtained from the sale will be released after the payment is credited. Therefore, the total amount indicated in the report may not always coincide with your total balance or the total amount in billing reports. -### Use the report to reconcile +Release deadlines are related to banking processes and mediation flows when transactions are made on Mercado Livre. Additionally, disputes and complaints received in sales can impact money release. -**This report is used to reconcile** the money that exists in your account at any given time and includes the transactions that make up those movements. +> For the exact date of availability of funds from a transaction, it is important to review [the details of credited payments](https://www.mercadopago.com.br/activities/balance). -Generate the release report every time you need to reconcile the detail of the money released between two dates. You will be able to know when each transaction was made, in what concept and for what amount, including the cases of blocking and unblocking. +## Using the report -### Use the report to view your history +The Release Report is an essential tool for both reconciliation and analysis of your financial history. It details account transactions, provides understanding and reconciliation of available balances on specific dates, and provides data for each transaction, including date, concept, and amount. -In addition, you can use the report to know the history of releases between two dates or two withdrawals, the detail of the events that make up an automatic or manual withdrawal (total or partial), the detail of disputes, refunds, shipments, chargebacks , taxes and other operations that affect the available balance and the detail of the installments released and the ones that are still to be paid. +Furthermore, this report presents the complete history of released money, covering events such as bank transfers, disputes, refunds, and chargebacks, and highlights settled installments compared to those pending payment. > NOTE > -> Note -> -> Have the [Releases report Glossary](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand to review it when needed or want to review a technical term. \ No newline at end of file +> Use the [Release Report Glossary](https://www.mercadopago.com.br/developers/en/docs/checkout-pro/additional-content/reports/released-money/report-use) for technical term reference, if needed. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.es.md b/guides/additional-content/reports/released-money/introduction.es.md index 5fbe062809..206a2b6b58 100644 --- a/guides/additional-content/reports/released-money/introduction.es.md +++ b/guides/additional-content/reports/released-money/introduction.es.md @@ -1,65 +1,64 @@ ----[mla]---- -# ¿Qué es el reporte de Liquidaciones? +# Reporte de Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- -# ¿Qué es el reporte de Liberaciones? +# Reporte de Liberaciones ------------ -El reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ es un **informe descargable que te permite conocer cómo está compuesto tu dinero disponible en Mercado Pago.** Contiene el **detalle de todos los fondos involucrados en un período de fechas,** e incluye los casos de ----[mla]---- liquidación ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberación ------------ de dinero como de bloqueos y desbloqueos. +El Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ es un archivo que se puede descargar y detalla el saldo disponible en tu cuenta de Mercado Pago. No solo muestra el valor total disponible, sino que también proporciona información sobre las transacciones realizadas en un período determinado, incluyendo situaciones como bloqueos y desbloqueos de fondos. +Además, le permite saber si su dinero se encuentra en un estado disponible o retirado, y puede solicitar esta información para el período de fechas que le resulte más conveniente. Ten presente que actualmente este reporte solo se genera a través de tu computadora. + +----[mpe]---- +## Análisis de los reportes a partir de enero de 2022 +------------ +----[mlu]---- +## Análisis de los reportes a partir de marzo de 2022 +----[mlc, mco]---- +## Análisis de los reportes a partir de agosto de 2022 +------------ +----[mla, mlm]---- +## Análisis de los reportes a partir de octubre de 2022 +------------ ----[mlb]---- -> WARNING -> -> Importante -> -> Los informes que generes a partir del 1 de enero de 2023 mostrarán los movimientos de tu dinero en orden cronológico, por eso podrás identificarlos más fácilmente y controlar mejor las finanzas de tu negocio. [Conoce cómo utilizarlo.](https://bit.ly/3QiCD2f) +## Análisis de los reportes a partir de enero de 2023 ------------ -## ¿Cómo descargo el reporte? - -Ten en cuenta que la generación del reporte lleva unos minutos dependiendo de cuánta información quieras que incluya. No siempre estará listo al instante y, hasta que lo esté, verás el estado *En preparación* en la pantalla. +Los informes que genere a partir de ----[mpe]---- enero de 2022------------ ----[mlu]---- marzo de 2022------------ ----[mla, mlm]---- octubre de 2022------------ ----[mco, mlc]---- agosto de 2022------------ ----[mlb]---- enero de 2023------------ tienen las siguientes características: -Una vez disponible, estará en tu bandeja de reportes y siempre lo podrás descargar de dos formas: +1. Los movimientos ahora se presentan en el orden en que ocurrieron, con lo cual puedess identificarlos con mayor facilidad y controlar tus ventas. +2. En caso de reclamación o contracargo relacionada con algún problema en el servicio o producto que vendiste, el valor correspondiente se retiene hasta que se resuelva la mediación. Esta información se refleja en su reporte y puede encontrarse buscando el prefijo "reserve-". +3. Las transacciones relacionadas con retiros y/o transferencias de su saldo disponible aparecen como _payout_, y todas las mediaciones que surgen cuando se inicia o resuelve una reclamación aparecen como _dispute_. Para obtener la descripción de otras transacciones y términos, consulte [el glosario](/developers/es/docs/checkout-pro/additional-content/reports/released-money/report-use). +4. Encontrará una nueva columna llamada "Sale detail" o "Detalle de venta" que proporciona información detallada sobre los artículos vendidos, facilitando la conciliación y el control de sus ventas. Cada entrada en esta columna muestra el primer elemento de la venta, seguido del agrupamiento de otros artículos. -* Desde un link de descarga que te enviaremos por e-mail. -* Desde tu cuenta de Mercado Pago, en ----[mla, mlm]---- *Reportes de tus cobros y estados de cuenta.* ------------ ----[mlb, mpe, mlu, mco]---- *Reportes*. ------------ +## Descargar reporte -### Valores del reporte +Siga esta ruta para saber cómo generar y descargar el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------: +**Informes y facturación -> Informes de ventas y extractos de cuenta -> ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------**. -Dependiendo de las [tasas y plazos](https://www.mercadopago[FAKER][URL][DOMAIN]/settings/release-options) que elijas, el dinero que ganes por una venta se va a liquidar un tiempo después de acreditado el cobro. Por esta razón, el valor total que verás en el reporte no siempre va a coincidir con tu saldo total o con el valor que veas en los reportes de facturación. +### Crear reporte por API -Los plazos de liquidación tienen que ver con los tiempos de los bancos o por los flujos de intermediación cuando las operaciones se realizan en Mercado Libre. Otras operaciones que pueden afectar la liquidación de tu dinero son los Contracargos y Reclamos que puedas recibir por una venta. +Genera el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ manualmente tantas veces desee o prográmelo según sus necesidades de frecuencia a través de la [API](/developers/es/docs/checkout-pro/additional-content/reports/released-money/api). -> Para saber la fecha exacta en la que estará disponible el dinero de una operación, revisa el [detalle de tus cobros acreditados](https://www.mercadopago[FAKER][URL][DOMAIN]/activities/balance). +La generación del reporte lleva algunos minutos dependiendo de cuánta información desee incluir. No siempre estará listo instantáneamente y, hasta que lo esté, verá el estado "En preparación" en la pantalla. -## Para qué usar el reporte +> Consulte ["Cómo analizar el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------?"](https://www.mercadopago.com.ar/ayuda/28771) para comprender mejor su reporte. -### Usa el reporte para conciliar +### Valores del reporte -**Este reporte se usa para conciliar** el dinero que existe en tu cuenta en un momento determinado e incluye las transacciones que componen a esos movimientos. +Dependiendo de las [tasas y plazos](https://www.mercadopago.com.ar/settings/release-options) seleccionados, el valor obtenido con la venta se va a liquidar un tiempo después de acreditado el cobro. Por lo tanto, el valor total indicado en el reporte puede no coincidir siempre con su saldo total o con el valor total en los reportes de facturación. -Genera el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ cada vez que necesites conciliar el detalle del dinero liberado entre dos fechas. Podrás saber cuándo se hizo cada transacción, en qué concepto ----[mlb, mpe, mlu, mco]---- y por qué monto, incluyendo los casos de bloqueo y desbloqueo. ------------ ----[mla, mlm]---- y por qué monto. ------------ +Los plazos de liberación están relacionados con los procesos bancarios y los flujos de intermediación cuando las transacciones se realizan en Mercado Libre. Además, las reclamaciones y contracargos recibidas en las ventas pueden afectar la liberación del dinero. -### Usa el reporte para conocer tu historial +> Para obtener la fecha exacta de disponibilidad del dinero de una transacción, es importante revisar los [detalles de los pagos acreditados.](https://www.mercadopago.com.ar/activities/balance) -Además, puedes usar el reporte para conocer el historial de dinero ----[mla]---- liquidado ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- liberado ------------ entre dos fechas, el detalle de los eventos que componen una transferencia bancaria, el detalle de disputas, reembolsos, envíos, contracargos, impuestos y otras operaciones. También verás el detalle de las cuotas liquidadas y las cuotas que aún faltan saldar. +## Uso del reporte -----[mpe, mlu]---- -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de Liberaciones para revisarlo cuando lo necesites o quieras consultar algún término técnico. +El reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ es una herramienta importante tanto para la conciliación como para el análisis de su historial financiero. Detalla las transacciones de la cuenta, proporciona comprensión y conciliación del saldo disponible en fechas específicas y ofrece datos de cada transacción, incluyendo la fecha, concepto y el monto. -> INFO -> -> Encuentra con mayor facilidad todos tus movimientos -> -> A partir de ------------ ----[mpe]----enero de 2022 ------------ ----[mlu]---- marzo de 2022 ------------ ----[mpe, mlu]---- este reporte muestra tus movimientos en orden cronológico, para que sea más fácil identificar cuándo se realizaron. Este cambio no se visualiza en los reportes que generes con fechas previas. +Además, este reporte presenta el historial completo del dinero liberado, abordando eventos como transferencias bancarias, disputas, reembolsos y estornos, y destaca las cuotas liquidadas en comparación con las pendientes de pago. ------------- -----[mlm, mlb, mlc, mco, mla]---- -> NOTE -> -> Nota +> NOTA > -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ------------ ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu]---- Liberaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mla]---- para revisarlo cuando lo necesites o quieras consultar algún término técnico. - ------------- \ No newline at end of file +> Utilice el [Glosario del reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](/developers/es/docs/checkout-pro/additional-content/reports/released-money/report-use) para consultar términos técnicos, si es necesario. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.pt.md b/guides/additional-content/reports/released-money/introduction.pt.md index b702866219..53bc346141 100644 --- a/guides/additional-content/reports/released-money/introduction.pt.md +++ b/guides/additional-content/reports/released-money/introduction.pt.md @@ -14,7 +14,7 @@ Além disso, permite que você saiba se o seu dinheiro está disponível ou não ## Análise dos relatórios a partir de janeiro de 2022 ------------ ----[mlu]---- -## Análise dos relatórios a partir de marchar de 2022 +## Análise dos relatórios a partir de março de 2022 ----[mlc, mco]---- ## Análise dos relatórios a partir de agosto de 2022 ------------ @@ -25,7 +25,7 @@ Além disso, permite que você saiba se o seu dinheiro está disponível ou não ## Análise dos relatórios a partir de janeiro de 2023 ------------ -Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022------------ ----[mlu]----marchar de 2022------------ ----[mla, mlm]----outubro de 2022------------ ----[mco, mlc]----agosto de 2022------------ ----[mlb]----janeiro de 2023------------ têm as seguintes características: +Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022------------ ----[mlu]----março de 2022------------ ----[mla, mlm]----outubro de 2022------------ ----[mco, mlc]----agosto de 2022------------ ----[mlb]----janeiro de 2023------------ têm as seguintes características: 1. As movimentações são mostradas em ordem cronológica, o que permite identificá-las mais facilmente e ter ainda mais controle sobre suas vendas. 2. Caso haja alguma reclamação ou contestação referente a algum problema com o serviço ou produto oferecido, o valor correspondente fica retido até a mediação ser resolvida. Essas informações constam no seu relatório e você pode encontrá-las ao procurar pelo prefixo "reserve-". @@ -34,16 +34,16 @@ Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022--------- ## Baixar relatório -Siga este caminho para saber como gerar e baixar o relatório de Liberações: -**Relatórios e faturamento -> Relatórios de vendas e extratos de conta -> Liberações**. +Siga este caminho para saber como gerar e baixar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------: +**Relatórios e faturamento -> Relatórios de vendas e extratos de conta -> ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------**. ### Criar relatório por API -Crie o relatório de Liberações manualmente quantas vezes desejar ou programe-o conforme suas necessidades de frequência por meio da [API](/developers/pt/docs/checkout-pro/additional-content/reports/released-money/api). +Crie o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ manualmente quantas vezes desejar ou programe-o conforme suas necessidades de frequência por meio da [API](/developers/pt/docs/checkout-pro/additional-content/reports/released-money/api). A geração do relatório leva alguns minutos, dependendo de quanta informação você deseja incluir. Nem sempre estará pronto instantaneamente e, até que esteja, você verá o status "Em preparação" na tela. -> Consulta ["Como analisar o relatório de Liberações?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. +> Consulta ["Como analisar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. ### Valores do relatório diff --git a/guides/additional-content/reports/released-money/panel.en.md b/guides/additional-content/reports/released-money/panel.en.md index cac50d5b5a..fd6475b80b 100644 --- a/guides/additional-content/reports/released-money/panel.en.md +++ b/guides/additional-content/reports/released-money/panel.en.md @@ -1,17 +1,9 @@ -# Generation by the Mercado Pago panel +# Generate report through the panel -Generate your Release report from your Mercado Pago panel. +Generate your Releases Reports from your Mercado Pago panel. You can schedule the report to be generated each time you withdraw funds from your balance to a bank account. To do this, follow the steps below: +1. From your Mercado Pago account, click [Sales and Billing](https://www.mercadopago.com.br/balance/reports) in the left menu. +2. Select the option **Sales and Account Statement Reports -> [Releases](https://www.mercadopago.com.br/balance/reports/release)** and click **Generate report**. +3. Search for transactions by time period and select the ones you want to reconcile. +4. Click **Generate**. The report will be _In preparation_, and you will receive an email when it's ready. -Follow these steps to generate your reports: - -1. From your Mercado Pago account, go to your reports and select the *Reports* option. -2. Go to [Release report](https://www.mercadopago.com.ar/balance/reports/release) and click on *Create report*. -3. Search the transactions per period of time and select the ones you wish to reconcile. - -Done! You will see your report *In preparation*. - -> NOTE -> -> Important -> -> Have the [Glossary of Releases report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand to review it when needed or want to review a technical term. \ No newline at end of file +> Have the [Glossary of the Releases Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand for reference whenever needed or to check any technical terms. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/panel.es.md b/guides/additional-content/reports/released-money/panel.es.md index 86915cddc9..3bf520d907 100644 --- a/guides/additional-content/reports/released-money/panel.es.md +++ b/guides/additional-content/reports/released-money/panel.es.md @@ -14,4 +14,18 @@ Sigue estos pasos para generar tus reportes: > > Importante > -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ para revisarlo cuando lo necesites o quieras consultar algún término técnico. \ No newline at end of file +> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ para revisarlo cuando lo necesites o quieras consultar algún término técnico. + + + + + +# Generar reporte desde el panel + +Genera tus Reportes de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ desde tu panel de Mercado Pago. Puedes programar la generación del reporte cada vez que realices un retiro de tu saldo a una cuenta bancaria. Para ello, sigue los pasos a continuación: +1. Desde tu cuenta de Mercado Pago, haz clic en [Informes y facturación](https://www.mercadopago.com.ar/balance/reports) en el menú izquierdo. +2. Selecciona la opción **Reportes de ventas y extractos de cuenta -> [----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](https://www.mercadopago.com.ar/balance/reports/release)** y haz clic en **Crear reporte**. +3. Busca las transacciones por período de tiempo y selecciona las que deseas conciliar. +4. Haz clic en **Generar**. El informe estará _En preparación_ y recibirás un correo electrónico cuando esté listo. + +> Ten a mano el [Glosario del Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) para consultar siempre que sea necesario o para verificar algún término técnico. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/panel.pt.md b/guides/additional-content/reports/released-money/panel.pt.md index 540e6af4ad..3d4c1a7b16 100644 --- a/guides/additional-content/reports/released-money/panel.pt.md +++ b/guides/additional-content/reports/released-money/panel.pt.md @@ -1,9 +1,9 @@ # Gerar relatório pelo painel -Gere seus relatórios de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ a partir do seu painel do Mercado Pago. Você poderá programar para que o relatório seja gerado cada vez que você fizer um saque do seu saldo para uma conta bancária. Para isso, siga as etapas abaixo: +Gere seus Relatórios de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ a partir do seu painel do Mercado Pago. Você poderá programar para que o relatório seja gerado cada vez que você fizer um saque do seu saldo para uma conta bancária. Para isso, siga as etapas abaixo: 1. A partir da sua conta do Mercado Pago, clique em [Relatórios e faturamento](https://www.mercadopago.com.br/balance/reports) no menu esquerdo. -2. Selecione a opção [----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago.com.br/balance/reports/release) e clique em **Criar relatório**. +2. Selecione a opção **Relatórios de vendas e extratos de conta -> [----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago.com.br/balance/reports/release)** e clique em **Criar relatório**. 3. Busque as transações por período de tempo e selecione as que deseja conciliar. 4. Clique em **Gerar**. O relatório estará _Em preparação_ e você receberá um e-mail quando estiver pronto. -> Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file +> Tenha o [Glossário do Relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. \ No newline at end of file From 3c883ba4e1d4e75ea30f720be47ddf12d0c6528f Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 06:08:02 -0300 Subject: [PATCH 7/9] 30 --- .../reconciliation-reports.en.md | 4 ++-- .../reconciliation-reports.es.md | 2 +- .../reports/released-money/api.en.md | 6 ++--- .../reports/released-money/api.es.md | 5 ++-- .../reports/released-money/generate.es.md | 12 +++++----- .../reports/released-money/how-to-use.en.md | 4 ++-- .../reports/released-money/how-to-use.es.md | 2 +- .../reports/released-money/introduction.en.md | 24 ++++++++++--------- .../reports/released-money/introduction.es.md | 8 +++---- .../reports/released-money/introduction.pt.md | 6 ++--- .../reports/released-money/panel.es.md | 22 ----------------- 11 files changed, 38 insertions(+), 57 deletions(-) diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md index f2204a6af4..124cea55fc 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md @@ -4,7 +4,7 @@ The reports from Mercado Pago provide financial information to track the movemen > WARNING > -> The Available Balance report was disabled on March 1, 2022 +> The Available Money report was disabled on March 1, 2022 > > You can use the [Released Money Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile the transactions that affect the balance available in your account, including your bank withdrawals. @@ -15,5 +15,5 @@ Check the table below for more details on the available report types. | Released Money Report | Provides the composition of the available balance in your account, with details about the values involved in a specific period. Read the [Released Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) for more information. | | Account Money Report | Informs about transactions/movements that have affected your account balance. For more information, read the [Account Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/account-money/introduction). | | Available Money Report | Presents the liquidity of your business, detailing the available amount in the account for use. For more information, read the [Available Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/available-money/introduction). -

* **This report is no longer available**. Use the [Released Money Report](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile transactions that constitute the available balance in your account, including bank withdrawals. | +
**This report is no longer available**. Use the [Released Money Report](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile transactions that constitute the available balance in your account, including bank withdrawals. | | Mercado Pago’s split payment solution sales report | The Mercado Pago’s split payment solution sales report offers a comprehensive overview of transactions from linked sellers, available for download in _csv_ and js_on formats. To learn more, read the [documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md index ede457bd45..20d120a6bc 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md @@ -15,6 +15,6 @@ Consulta la tabla a continuación para obtener más detalles sobre los tipos de | ----[mlm, mlb, mlc, mco, mlu, mpe]---- Reporte de Liberaciones ------------ ----[mla]---- Reporte de Liquidaciones ------------ | Proporciona la composición del saldo disponible en su cuenta, con detalles sobre los valores involucrados en un período determinado. Consulte la [documentación de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para obtener más información. | | Reporte de Dinero en cuenta | Informa sobre las transacciones/movimientos que afectaron su saldo en cuenta. Para obtener más información, consulte la [documentación de Dinero en cuenta](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/account-money/introduction). | | Reporte de Dinero disponible | Presenta la liquidez de su negocio, detallando el valor disponible en cuenta para su uso. Para obtener más información, consulte la [documentación de Dinero disponible](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/available-money/introduction). -

* **Este reporte ya no está disponible**. Utilice el [Reporte de Liberaciones](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones que componen el saldo disponible en su cuenta, incluyendo los retiros bancarios. | +
**Este reporte ya no está disponible**. Utilice el [Reporte de Liberaciones](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones que componen el saldo disponible en su cuenta, incluyendo los retiros bancarios. | | Reportes de Facturación | El **Marketplace de Mercado Libre** ha desarrollado una serie de reportes de facturación para proporcionar detalles financieros de las transacciones realizadas en Mercado Pago a partir de las ventas en Mercado Libre.

Los datos de los reportes también incluyen información financiera de usuarios que no realizan ventas en Mercado Libre, ya que los datos de facturación son de Mercado Pago. Para obtener más información, consulte la [documentación](https://developers.mercadolibre.com.ar/es_ar/reportes-de-facturacion).| | Reporte de Ventas de la Solución Split de Pagos do Mercado Pago | El Reporte de ventas de la solución split de pagos do Mercado Pago ofrece una visión completa de las transacciones de los vendedores vinculados, disponible para su descarga en los formatos _csv_ y _json_. Para obtener más información, consulte la [documentación](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/api.en.md b/guides/additional-content/reports/released-money/api.en.md index 12ab67161a..4b52d42292 100644 --- a/guides/additional-content/reports/released-money/api.en.md +++ b/guides/additional-content/reports/released-money/api.en.md @@ -1,8 +1,8 @@ -# Generate Report via API +# Generate report via API -Generate the Release Report manually as many times as you want or schedule it according to the desired frequency through our API. +Generate the Releases Report manually as many times as you want or schedule it according to the desired frequency through our API. -## Configure the Release Report +## Configure the Releases Report ### Configurable attributes diff --git a/guides/additional-content/reports/released-money/api.es.md b/guides/additional-content/reports/released-money/api.es.md index 2fd9e135a8..85f76413d4 100644 --- a/guides/additional-content/reports/released-money/api.es.md +++ b/guides/additional-content/reports/released-money/api.es.md @@ -1,8 +1,8 @@ # Crear reporte a través de la API -Crea el Reporte de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ manualmente tantas veces como desees o prográmalo según la frecuencia deseada a través de nuestra API. +Crea el Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ manualmente tantas veces como desees o prográmalo según la frecuencia deseada a través de nuestra API. -## Configurar el Reporte de ----[mla]----Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberações------------ +## Configurar el Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ ### Atributos configurables @@ -730,6 +730,7 @@ En ausencia de errores, se emitirá un código de estado `HTTP 202 (Accepted)`. ----[mlm, mla, mco, mpe, mlu, mlc]---- Una respuesta `HTTP STATUS 203 (Non-Authoritative Information)` indica que la solicitud se realizó según lo esperado; sin embargo, no fue posible crear su reporte y será necesario solicitarlo nuevamente con las fechas indicadas en el sistema. +------------ ### Consultar reporte Consulta la API según se muestra a continuación para explorar la lista de reportes que has generado: diff --git a/guides/additional-content/reports/released-money/generate.es.md b/guides/additional-content/reports/released-money/generate.es.md index d859301454..a319434219 100644 --- a/guides/additional-content/reports/released-money/generate.es.md +++ b/guides/additional-content/reports/released-money/generate.es.md @@ -24,8 +24,8 @@ Puedes generar un reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, | Canales | Descripción | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Panel de Mercado Pago | Es posible crear el reporte manualmente a través del panel de Mercado Pago. Accede a la sección de [Informes y facturación](https://www.mercadopago.com.ar/movements), haz clic en **Ir a reportes de pagos y extractos de cuenta** y selecciona el reporte. Para obtener más información, consulta la documentación [Generar informe desde el panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/panel). | -| Integración vía API | Crea el reporte manualmente o programa su generación según la frecuencia deseada utilizando nuestra integración a través de la API. Para obtener más información, consulta la documentación [Generar informe a través de la API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/api). | +| Panel de Mercado Pago | Es posible crear el reporte manualmente a través del panel de Mercado Pago. Accede a la sección de [Informes y facturación](https://www.mercadopago.com.ar/movements), haz clic en **Ir a reportes de pagos y extractos de cuenta** y selecciona el reporte. Para obtener más información, consulta la documentación [Generar reporte desde el panel](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/panel). | +| Integración vía API | Crea el reporte manualmente o programa su generación según la frecuencia deseada utilizando nuestra integración a través de la API. Para obtener más información, consulta la documentación [Generar reporte a través de la API](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/api). | ## Características técnicas del reporte @@ -33,7 +33,7 @@ Ten en cuenta la siguiente información técnica siempre que estés creando, pro ### Estructura del reporte -Comprende las características de los elementos que componen tu informe. +Comprende las características de los elementos que componen tu reporte. | Elemento o acción | Características | | --- | --- | @@ -50,15 +50,15 @@ Todas las opciones disponibles al descargar tu reporte. | Elemento o acción | Características | | --- | --- | -| Formato del nombre del archivo | Informe programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2024.csv. | +| Formato del nombre del archivo | Reporte programado o manual:
"prefijo-configurable-fecha-de-creación.csv"
Ejemplo: mitienda-28-05-2024.csv. | | Formatos de descarga | ._csv_, ._xlsx_

**Nota**: descarga el reporte en formato ._csv_ para importar los datos y usarlos en otras aplicaciones. Descárgalo en formato ._xlsx_ para leer la información en tablas de hojas de cálculo. | -| Archivo | Los informes generados se guardan en tu cuenta de Mercado Pago. | +| Archivo | Los reportes generados se guardan en tu cuenta de Mercado Pago. | ## Notificaciones ### Webhook -Webhook, también conocido como "retorno de llamada web", es un método eficiente para recibir información en tiempo real cada vez que ocurre un evento en una aplicación o sistema. Este enfoque permite la transferencia pasiva de datos entre dos sistemas mediante solicitudes HTTP POST. En relación con los informes utilizados en la conciliación, se envía una notificación al usuario que haya configurado este servicio cuando sus archivos sean generados. +Webhook, también conocido como "retorno de llamada web", es un método eficiente para recibir información en tiempo real cada vez que ocurre un evento en una aplicación o sistema. Este enfoque permite la transferencia pasiva de datos entre dos sistemas mediante solicitudes HTTP POST. En relación con los reportes utilizados en la conciliación, se envía una notificación al usuario que haya configurado este servicio cuando sus archivos sean generados. | Atributo | Descripción | |-----------------|-----------------------------------| diff --git a/guides/additional-content/reports/released-money/how-to-use.en.md b/guides/additional-content/reports/released-money/how-to-use.en.md index bfe311018d..09b05e0bf6 100644 --- a/guides/additional-content/reports/released-money/how-to-use.en.md +++ b/guides/additional-content/reports/released-money/how-to-use.en.md @@ -29,11 +29,11 @@ If a transfer is not completed, the report remains valid. The amount will be ref > > Important > -> Have the [Release Report Glossary](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/released-money/glossary) on hand to consult when needed to check any technical term. +> Have the [Releases Report Glossary](https://www.mercadopago.com.br/developers/en/guides/additional-content/reports/released-money/glossary) on hand to consult when needed to check any technical term. ## Report example -Observe what comprises the Release Report in the following example to identify the sections and analyze your own reports: +Observe what comprises the Releases Report in the following example to identify the sections and analyze your own reports: ----[mla]---- ![Reporte de liquidaciones](/images/manage-account/reports/example-release-es.jpg) diff --git a/guides/additional-content/reports/released-money/how-to-use.es.md b/guides/additional-content/reports/released-money/how-to-use.es.md index f419728e23..bd30b4a2f8 100644 --- a/guides/additional-content/reports/released-money/how-to-use.es.md +++ b/guides/additional-content/reports/released-money/how-to-use.es.md @@ -25,7 +25,7 @@ Los saldos disponibles de las transacciones liquidadas se muestran en las column Si esto pasa, el reporte sigue siendo válido. El dinero vuelve a tu cuenta y la operación aparecerá en el reporte como una nueva línea en la columna `NET_CREDIT_AMOUNT`. -> NOTA +> NOTE > > Importante > diff --git a/guides/additional-content/reports/released-money/introduction.en.md b/guides/additional-content/reports/released-money/introduction.en.md index eb0a98eb21..d46b251543 100644 --- a/guides/additional-content/reports/released-money/introduction.en.md +++ b/guides/additional-content/reports/released-money/introduction.en.md @@ -1,22 +1,22 @@ -# Release report +# Releases report The Releases Report is a downloadable file detailing the balance available in your Mercado Pago account. It not only displays the total available amount but also provides information on transactions conducted within a specified period, including situations like fund blocks and unblocks. Additionally, it informs you whether your money is available or not, allowing you to request this information for a convenient date range. Keep in mind that currently, this report is only generated through your computer. ----[mpe]---- -## Analysis of Reports from January 2022 +## Analysis of reports from January 2022 ------------ ----[mlu]---- -## Analysis of Reports from March 2022 +## Analysis of reports from March 2022 ----[mlc, mco]---- -## Analysis of Reports from August 2022 +## Analysis of reports from August 2022 ------------ ----[mla, mlm]---- -## Analysis of Reports from October 2022 +## Analysis of reports from October 2022 ------------ ----[mlb]---- -## Analysis of Reports from January 2023 +## Analysis of reports from January 2023 ------------ The reports you generate from ----[mpe]----January 2022------------ ----[mlu]----March 2022------------ ----[mla, mlm]----October 2022------------ ----[mco, mlc]----August 2022------------ ----[mlb]----January 2023------------ have the following characteristics: @@ -28,16 +28,16 @@ The reports you generate from ----[mpe]----January 2022------------ ----[mlu]-- ## Download report -Follow this path to learn how to generate and download the Release Report: +Follow this path to learn how to generate and download the Releases Report: **Reports and Billing -> Sales and Account Statements -> Release**. ### Create report via API -Manually create the Release Report as often as you wish or schedule it according to your frequency needs through the [API](/developers/en/docs/checkout-pro/additional-content/reports/released-money/api). +Manually create the Releases Report as often as you wish or schedule it according to your frequency needs through the [API](/developers/en/docs/checkout-pro/additional-content/reports/released-money/api). Report generation takes a few minutes, depending on how much information you want to include. It won't always be ready instantly, and until it is, you will see the status "In preparation" on the screen. -> Refer to ["How to analyze the Release Report"](https://www.mercadopago.com.br/ajuda/28771) for a better understanding of your report. +> Refer to ["How to analyze the Releases Report?"](https://www.mercadopago.com.br/ajuda/28771) for a better understanding of your report. ### Report values @@ -49,10 +49,12 @@ Release deadlines are related to banking processes and mediation flows when tran ## Using the report -The Release Report is an essential tool for both reconciliation and analysis of your financial history. It details account transactions, provides understanding and reconciliation of available balances on specific dates, and provides data for each transaction, including date, concept, and amount. +The Releases Report is an essential tool for both reconciliation and analysis of your financial history. It details account transactions, provides understanding and reconciliation of available balances on specific dates, and provides data for each transaction, including date, concept, and amount. Furthermore, this report presents the complete history of released money, covering events such as bank transfers, disputes, refunds, and chargebacks, and highlights settled installments compared to those pending payment. > NOTE > -> Use the [Release Report Glossary](https://www.mercadopago.com.br/developers/en/docs/checkout-pro/additional-content/reports/released-money/report-use) for technical term reference, if needed. \ No newline at end of file +> Note +> +> Use the [Releases Report Glossary](https://www.mercadopago.com.br/developers/en/docs/checkout-pro/additional-content/reports/released-money/report-use) for technical term reference, if needed. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.es.md b/guides/additional-content/reports/released-money/introduction.es.md index 206a2b6b58..5b205267ab 100644 --- a/guides/additional-content/reports/released-money/introduction.es.md +++ b/guides/additional-content/reports/released-money/introduction.es.md @@ -35,7 +35,7 @@ Los informes que genere a partir de ----[mpe]---- enero de 2022------------ --- ## Descargar reporte Siga esta ruta para saber cómo generar y descargar el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------: -**Informes y facturación -> Informes de ventas y extractos de cuenta -> ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------**. +**Informes y facturación** -> **Informes de ventas y extractos de cuenta** -> ----[mla]---- **Liquidaciones** ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- **Liberaciones** ------------. ### Crear reporte por API @@ -43,7 +43,7 @@ Genera el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc La generación del reporte lleva algunos minutos dependiendo de cuánta información desee incluir. No siempre estará listo instantáneamente y, hasta que lo esté, verá el estado "En preparación" en la pantalla. -> Consulte ["Cómo analizar el reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------?"](https://www.mercadopago.com.ar/ayuda/28771) para comprender mejor su reporte. +> Consulte ["Cómo analizar el reporte de ----[mla]---- Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones------------?"](https://www.mercadopago.com.ar/ayuda/28771) para comprender mejor su reporte. ### Valores del reporte @@ -59,6 +59,6 @@ El reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, Además, este reporte presenta el historial completo del dinero liberado, abordando eventos como transferencias bancarias, disputas, reembolsos y estornos, y destaca las cuotas liquidadas en comparación con las pendientes de pago. -> NOTA +> NOTE > -> Utilice el [Glosario del reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](/developers/es/docs/checkout-pro/additional-content/reports/released-money/report-use) para consultar términos técnicos, si es necesario. \ No newline at end of file +> Utilice el [Glosario del Reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](/developers/es/docs/checkout-pro/additional-content/reports/released-money/report-use) para consultar términos técnicos, si es necesario. \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.pt.md b/guides/additional-content/reports/released-money/introduction.pt.md index 53bc346141..fd19600f06 100644 --- a/guides/additional-content/reports/released-money/introduction.pt.md +++ b/guides/additional-content/reports/released-money/introduction.pt.md @@ -35,7 +35,7 @@ Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022--------- ## Baixar relatório Siga este caminho para saber como gerar e baixar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------: -**Relatórios e faturamento -> Relatórios de vendas e extratos de conta -> ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------**. +**Relatórios e faturamento** -> **Relatórios de vendas e extratos de conta** -> ----[mla]---- **Liquidações** ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- **Liberações** ------------. ### Criar relatório por API @@ -43,11 +43,11 @@ Crie o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc A geração do relatório leva alguns minutos, dependendo de quanta informação você deseja incluir. Nem sempre estará pronto instantaneamente e, até que esteja, você verá o status "Em preparação" na tela. -> Consulta ["Como analisar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. +> Consulta ["Como analisar o relatório de ----[mla]---- Liquidações------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações------------?"](https://www.mercadopago.com.br/ajuda/28771) para entender melhor o seu relatório. ### Valores do relatório -Dependendo das [tarifas e prazos](/settings/release-options) selecionados, o valor obtido com a venda será liberado após o pagamento ser creditado. Por isso, o valor total indicado no relatório pode não coincidir sempre com seu saldo total ou com o valor total nos relatórios de faturamento. +Dependendo das [tarifas e prazos](https://www.mercadopago.com.br/settings/release-options) selecionados, o valor obtido com a venda será liberado após o pagamento ser creditado. Por isso, o valor total indicado no relatório pode não coincidir sempre com seu saldo total ou com o valor total nos relatórios de faturamento. Os prazos de liberação estão relacionados aos processos bancários e aos fluxos de intermediação quando as transações são feitas no Mercado Livre. Além disso, contestações e reclamações recebidas em vendas podem impactar a liberação do dinheiro. diff --git a/guides/additional-content/reports/released-money/panel.es.md b/guides/additional-content/reports/released-money/panel.es.md index 3bf520d907..ca4d820583 100644 --- a/guides/additional-content/reports/released-money/panel.es.md +++ b/guides/additional-content/reports/released-money/panel.es.md @@ -1,25 +1,3 @@ -# Generación por panel de Mercado Pago - -Genera tus reportes de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ desde tu panel de Mercado Pago. Podrás programar que se genere el reporte por cada vez que hagas un retiro de tu saldo a una cuenta bancaria. - -Sigue estos pasos para generar tus reportes: - -1. Desde tu cuenta de Mercado Pago, ve a ----[mla]---- [Informes y facturación](https://www.mercadopago.com.ar/balance/reports) ------------ ----[mlm]---- [Informes y facturación](https://www.mercadopago.com.ar/balance/reports) ------------ ----[mla, mlm]---- y elige la opción de *Reportes de tus cobros y estados de cuenta.* ------------ ----[mlb, mlc, mco, mlu, mpe]---- [tus Informes](https://www.mercadopago.com.ar/balance/reports) y elige la opción de *Reportes*. ------------ -2. Ve a [reporte de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------](https://www.mercadopago.com.ar/balance/reports/release) y haz click en *Crear Reporte*. -3. Busca las operaciones por período de tiempo y selecciona las que quieras conciliar. - -¡Y listo! Vas a ver tu reporte *En preparación*. - -> NOTE -> -> Importante -> -> Ten a mano el [Glosario del reporte](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/glossary) de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ para revisarlo cuando lo necesites o quieras consultar algún término técnico. - - - - - # Generar reporte desde el panel Genera tus Reportes de ----[mla]---- Liquidaciones ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberaciones ------------ desde tu panel de Mercado Pago. Puedes programar la generación del reporte cada vez que realices un retiro de tu saldo a una cuenta bancaria. Para ello, sigue los pasos a continuación: From f80e85ff19383e088a6e7a5eba4765040ce3631a Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 06:44:55 -0300 Subject: [PATCH 8/9] 40 --- .../general-considerations/reconciliation-reports.en.md | 3 +-- .../general-considerations/reconciliation-reports.es.md | 3 +-- .../reports/released-money/introduction.pt.md | 4 ++-- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md index 124cea55fc..558be7741f 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.en.md @@ -14,6 +14,5 @@ Check the table below for more details on the available report types. |---|---| | Released Money Report | Provides the composition of the available balance in your account, with details about the values involved in a specific period. Read the [Released Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) for more information. | | Account Money Report | Informs about transactions/movements that have affected your account balance. For more information, read the [Account Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/account-money/introduction). | -| Available Money Report | Presents the liquidity of your business, detailing the available amount in the account for use. For more information, read the [Available Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/available-money/introduction). -
**This report is no longer available**. Use the [Released Money Report](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile transactions that constitute the available balance in your account, including bank withdrawals. | +| Available Money Report | Presents the liquidity of your business, detailing the available amount in the account for use. For more information, read the [Available Money documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/available-money/introduction).
**This report is no longer available**. Use the [Released Money Report](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/introduction) to reconcile transactions that constitute the available balance in your account, including bank withdrawals. | | Mercado Pago’s split payment solution sales report | The Mercado Pago’s split payment solution sales report offers a comprehensive overview of transactions from linked sellers, available for download in _csv_ and js_on formats. To learn more, read the [documentation](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/en/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md index 20d120a6bc..7828f254ec 100644 --- a/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md +++ b/guides/additional-content/reports/general-considerations/reconciliation-reports.es.md @@ -14,7 +14,6 @@ Consulta la tabla a continuación para obtener más detalles sobre los tipos de |---|---| | ----[mlm, mlb, mlc, mco, mlu, mpe]---- Reporte de Liberaciones ------------ ----[mla]---- Reporte de Liquidaciones ------------ | Proporciona la composición del saldo disponible en su cuenta, con detalles sobre los valores involucrados en un período determinado. Consulte la [documentación de ----[mla]----Liquidaciones------------ ----[mlm, mlb, mlc, mco, mlu, mpe]----Liberaciones------------](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para obtener más información. | | Reporte de Dinero en cuenta | Informa sobre las transacciones/movimientos que afectaron su saldo en cuenta. Para obtener más información, consulte la [documentación de Dinero en cuenta](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/account-money/introduction). | -| Reporte de Dinero disponible | Presenta la liquidez de su negocio, detallando el valor disponible en cuenta para su uso. Para obtener más información, consulte la [documentación de Dinero disponible](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/available-money/introduction). -
**Este reporte ya no está disponible**. Utilice el [Reporte de Liberaciones](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones que componen el saldo disponible en su cuenta, incluyendo los retiros bancarios. | +| Reporte de Dinero disponible | Presenta la liquidez de su negocio, detallando el valor disponible en cuenta para su uso. Para obtener más información, consulte la [documentación de Dinero disponible](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/available-money/introduction).
**Este reporte ya no está disponible**. Utilice el [Reporte de Liberaciones](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/guides/additional-content/reports/released-money/introduction) para conciliar las transacciones que componen el saldo disponible en su cuenta, incluyendo los retiros bancarios. | | Reportes de Facturación | El **Marketplace de Mercado Libre** ha desarrollado una serie de reportes de facturación para proporcionar detalles financieros de las transacciones realizadas en Mercado Pago a partir de las ventas en Mercado Libre.

Los datos de los reportes también incluyen información financiera de usuarios que no realizan ventas en Mercado Libre, ya que los datos de facturación son de Mercado Pago. Para obtener más información, consulte la [documentación](https://developers.mercadolibre.com.ar/es_ar/reportes-de-facturacion).| | Reporte de Ventas de la Solución Split de Pagos do Mercado Pago | El Reporte de ventas de la solución split de pagos do Mercado Pago ofrece una visión completa de las transacciones de los vendedores vinculados, disponible para su descarga en los formatos _csv_ y _json_. Para obtener más información, consulte la [documentación](https://www.mercadopago.com[FAKER][URL][DOMAIN]/developers/es/docs/checkout-pro/additional-content/reports/sales-report/introduction). | \ No newline at end of file diff --git a/guides/additional-content/reports/released-money/introduction.pt.md b/guides/additional-content/reports/released-money/introduction.pt.md index fd19600f06..4ec21cc00e 100644 --- a/guides/additional-content/reports/released-money/introduction.pt.md +++ b/guides/additional-content/reports/released-money/introduction.pt.md @@ -34,8 +34,8 @@ Os relatórios que você gerar a partir de ----[mpe]----janeiro de 2022--------- ## Baixar relatório -Siga este caminho para saber como gerar e baixar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------: -**Relatórios e faturamento** -> **Relatórios de vendas e extratos de conta** -> ----[mla]---- **Liquidações** ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- **Liberações** ------------. +Siga este caminho para saber como gerar e baixar o relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações------------: +**Relatórios e faturamento** -> **Ielatórios de vendas e extratos de conta** -> ----[mla]---- **Liquidações** ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- **Liberações** ------------. ### Criar relatório por API From 3d013252d93a56fa02dc6ca3b974a40e49877f48 Mon Sep 17 00:00:00 2001 From: Gabrielly Date: Fri, 22 Dec 2023 10:50:34 -0300 Subject: [PATCH 9/9] 40 --- guides/additional-content/reports/released-money/generate.pt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/additional-content/reports/released-money/generate.pt.md b/guides/additional-content/reports/released-money/generate.pt.md index efca4d2566..9e01321958 100644 --- a/guides/additional-content/reports/released-money/generate.pt.md +++ b/guides/additional-content/reports/released-money/generate.pt.md @@ -11,7 +11,7 @@ Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[ ------------ -## Canais de geração +## Canais de criação Você pode gerar um relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------ pela sua conta Mercado Pago: